sp_spaceused (Transact-SQL)

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

sp_spaceused 시스템 저장 프로시저는 다음 중 하나를 표시합니다.

• 현재 데이터베이스의 테이블, 인덱싱된 뷰 또는 Service Broker 큐에서 사용하는 행 수, 예약된 디스크 공간 및 디스크 공간

• 전체 데이터베이스에서 예약 및 사용하는 디스크 공간

Transact-SQL 구문 표기 규칙

Syntax

sp_spaceused
    [ [ @objname = ] N'objname' ]
    [ , [ @updateusage = ] 'updateusage' ]
    [ , [ @mode = ] 'mode' ]
    [ , [ @oneresultset = ] oneresultset ]
    [ , [ @include_total_xtp_storage = ] include_total_xtp_storage ]
[ ; ]

인수

Azure Synapse Analytics 및 Analytics Platform System(PDW) sp_spaceused 의 경우 매개 변수의 서수 위치에 의존하지 않고 명명된 매개 변수(예 sp_spaceused (@objname= N'Table1');: )를 지정해야 합니다.

[ @objname = ] N'objname'

공간 사용 정보가 요청되는 테이블, 인덱싱된 뷰 또는 큐의 정규화된 이름 또는 정규화되지 않은 이름입니다. @objname 기본값NULL인 nvarchar(776)입니다. 따옴표는 정규화된 개체 이름이 지정된 경우에만 필요합니다. 정규화된 개체 이름(데이터베이스 이름 포함)이 제공된 경우 데이터베이스 이름은 현재 데이터베이스의 이름이어야 합니다.

@objname 지정하지 않으면 전체 데이터베이스에 대한 결과가 반환됩니다.

[ @updateusage = ] 'updateusage'

공간 사용량 정보를 업데이트하기 위해 실행되어야 했음을 나타냅니다 DBCC UPDATEUSAGE . @updateusage 기본값false인 varchar(5)입니다. @objname 지정되지 않으면 문이 전체 데이터베이스에서 실행됩니다. 그렇지 않으면 문이 @objname 실행됩니다. 값은 true 또는 false일 수 있습니다.

[ @mode = ] 'mode'

결과의 범위를 나타냅니다. 확장된 테이블 또는 데이터베이스의 경우 @mode 매개 변수를 사용하면 개체의 원격 부분을 포함하거나 제외할 수 있습니다. 자세한 내용은 Stretch Database를 참조하십시오.

@mode varchar(11)이며 이러한 값 중 하나일 수 있습니다.

[ @oneresultset = ] oneresultset

단일 결과 집합을 반환할지 여부를 나타냅니다. @oneresultset 비트이며 다음 값 중 하나일 수 있습니다.

[ @include_total_xtp_storage = ] include_total_xtp_storage

적용 대상: SQL Server 2017(14.x) 이상 버전 및 SQL Database

@oneresultset 설정1되면 이 매개 변수는 단일 결과 집합에 스토리지에 대한 MEMORY_OPTIMIZED_DATA 열이 포함되어 있는지 여부를 결정합니다. @include_total_xtp_storage 비트이며 기본값은 .입니다0. 이 경우 1XTP 열이 결과 집합에 포함됩니다.

반환 코드 값

0(성공) 또는 1(실패).

결과 집합

@objname 생략되고 @oneresultset 값이0면 다음 결과 집합이 반환되어 현재 데이터베이스 크기 정보를 제공합니다.

@objname 생략되고 @oneresultset 값이1면 현재 데이터베이스 크기 정보를 제공하기 위해 다음 단일 결과 집합이 반환됩니다.

@objname 지정하면 지정된 개체에 대해 다음 결과 집합이 반환됩니다.

매개 변수가 지정되지 않은 경우 이 모드는 기본값입니다. 다음 결과 집합은 디스크 데이터베이스 크기 정보를 자세히 설명하는 반환됩니다.

데이터베이스의 테이블에서 사용하는 공간입니다. 디스크 사용량에 대한 테이블별 회계가 없으므로 이 결과 집합은 메모리 최적화 테이블을 반영하지 않습니다.

다음 결과 집합은 데이터베이스에 하나 이상의 컨테이너가 있는 파일 그룹이 있는 MEMORY_OPTIMIZED_DATA 경우에만 반환됩니다.

@objname 생략하면 @oneresultset 값이 1@include_total_xtp_storage 1현재 데이터베이스 크기 정보를 제공하기 위해 다음 단일 결과 집합이 반환됩니다. @include_total_xtp_storage 0 (기본값)이면 마지막 세 열이 생략됩니다.

¹ @include_total_xtp_storage 설정된 1경우에만 포함됩니다.

설명

값은 database_size 일반적으로 로그 파일의 reservedunallocated space + 크기를 포함하기 때문에 합계보다 크지만 reserved unallocated_space 데이터 페이지만 고려합니다. Azure Synapse Analytics의 경우 이 설명이 사실이 아닐 수 있습니다.

XML 인덱스와 전체 텍스트 인덱스에 사용되는 페이지는 두 결과 집합에 모두 포함 index_size 됩니다. @objname 지정하면 개체에 대한 XML 인덱스 및 전체 텍스트 인덱스의 페이지도 합계 reserved 및 index_size 결과에 계산됩니다.

공간 인덱스인 데이터베이스 또는 개체에 대한 공간 사용량을 계산하는 경우 공간 크기 열(예: database_size, reserved및 index_size)에는 공간 인덱스의 크기가 포함됩니다.

@updateusage 지정되면 SQL Server 데이터베이스 엔진 데이터베이스의 데이터 페이지를 검사하고 sys.allocation_units 각 테이블에서 사용하는 스토리지 공간과 관련하여 필요한 수정 및 sys.partitions 카탈로그 뷰를 수행합니다. 예를 들어 인덱스를 삭제한 후 테이블의 공간 정보가 최신 상태가 아닐 수 있는 경우가 있습니다. @updateusage 큰 테이블 또는 데이터베이스에서 실행하는 데 다소 시간이 걸릴 수 있습니다. 잘못된 값이 반환되는 것으로 의심되고 프로세스가 데이터베이스의 다른 사용자 또는 프로세스에 부정적인 영향을 미치지 않는 경우에만 @updateusage 사용합니다. 기본 설정인 DBCC UPDATEUSAGE 경우 별도로 실행할 수 있습니다.

사용 권한

실행 sp_spaceused 권한은 공용 역할에 부여됩니다. db_owner 고정 데이터베이스 역할의 멤버만 @updateusage 매개 변수를 지정할 수 있습니다.

예제

A. 테이블에 대한 디스크 공간 정보 표시

다음 예제에서는 테이블 및 해당 인덱스에 대한 Vendor 디스크 공간 정보를 보고합니다.

USE AdventureWorks2022;
GO
EXEC sp_spaceused N'Purchasing.Vendor';
GO

B. 데이터베이스에 대한 업데이트된 공간 정보 표시

다음 예제에서는 현재 데이터베이스에 사용되는 공간을 요약하고 선택적 매개 변수 @updateusage 사용하여 현재 값이 반환되도록 합니다.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @updateusage = N'TRUE';
GO

C. 스트레치 사용 테이블과 연결된 원격 테이블에 대한 공간 사용량 정보 표시

다음 예제에서는 @mode 인수를 사용하여 원격 대상을 지정하여 스트레치 사용 테이블과 연결된 원격 테이블에서 사용하는 공간을 요약합니다. 자세한 내용은 Stretch Database를 참조하세요.

USE StretchedAdventureWorks2022;
GO

EXEC sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY';

D. 단일 결과 집합에서 데이터베이스에 대한 공간 사용량 정보 표시

다음 예제에서는 단일 결과 집합에서 현재 데이터베이스의 공간 사용량을 요약합니다.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;

E. 단일 결과 집합에 하나 이상의 MEMORY_OPTIMIZED 파일 그룹이 있는 데이터베이스에 대한 공간 사용량 정보 표시

다음 예제에서는 단일 결과 집합에 파일 그룹이 하나 MEMORY_OPTIMIZED 이상 있는 현재 데이터베이스의 공간 사용량을 요약합니다.

USE WideWorldImporters
GO

EXEC sp_spaceused @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '1',
    @include_total_xtp_storage = '1';
GO

F. 데이터베이스의 MEMORY_OPTIMIZED 테이블 개체에 대한 공간 사용량 정보 표시

다음 예제에서는 파일 그룹이 하나 MEMORY_OPTIMIZED 이상 있는 MEMORY_OPTIMIZED 현재 데이터베이스의 테이블 개체에 대한 공간 사용량을 요약합니다.

USE WideWorldImporters
GO

EXEC sp_spaceused @objname = N'VehicleTemperatures',
    @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '0',
    @include_total_xtp_storage = '1';
GO

관련 콘텐츠

• CREATE INDEX(Transact-SQL)
• CREATE TABLE (Transact-SQL)
• DBCC UPDATEUSAGE(Transact-SQL)
• Service Broker
• sys.allocation_units(Transact-SQL)
• sys.indexes(Transact-SQL)
• sys.index_columns(Transact SQL)
• sys.objects(Transact-SQL)
• sys.partitions(Transact-SQL)
• 시스템 저장 프로시저(Transact-SQL)