sys.dm_db_incremental_stats_properties (Transact-SQL)
적용 대상: 
SQL Server
현재 SQL Server 데이터베이스에서 지정된 데이터베이스 개체(테이블)에 대한 증분 통계의 속성을 반환합니다. sys.dm_db_incremental_stats_properties 사용은(파티션 번호 포함) 비증분 통계에 사용되는 sys.dm_db_stats_properties 와 비슷합니다.
이 함수는 SQL Server 2014(12.x) 서비스 팩 2 및 SQL Server 2016(13.x) 서비스 팩 1에서 도입되었습니다.
구문
sys.dm_db_incremental_stats_properties (object_id, stats_id)
인수
object_id
증분 통계 중 하나의 속성이 요청되는 현재 데이터베이스의 개체 ID입니다. object_id 는 int입니다.
stats_id
지정된 object_id 대한 통계 ID입니다. 통계 ID는 sys.stats 동적 관리 뷰에서 가져올 수 있습니다. stats_id는 int입니다.
반환된 테이블
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
| object_id | int | 통계 개체의 속성을 반환할 개체(테이블)의 ID입니다. |
| stats_id | int | 통계 개체의 ID입니다. 테이블 내에서 고유합니다. 자세한 내용은 sys.stats(Transact-SQL)를 참조하세요. |
| partition_number | int | 테이블의 일부를 포함하는 파티션 수입니다. |
| last_updated | datetime2 | 통계 개체가 마지막으로 업데이트된 날짜 및 시간입니다. 자세한 내용은 이 페이지의 주의 섹션을 참조하세요. |
| rows | bigint | 통계가 마지막으로 업데이트된 테이블의 총 행 수입니다. 통계가 필터링되거나 필터링된 인덱스에 해당하는 경우 행 수가 테이블의 행 수보다 적을 수 있습니다. |
| rows_sampled | bigint | 통계 계산을 위해 샘플링된 전체 행 수입니다. |
| steps | int | 히스토그램의 총 단계 수입니다. 자세한 내용은 DBCC SHOW_STATISTICS(Transact-SQL)를 참조하세요. |
| unfiltered_rows | bigint | 필터링된 통계의 필터 식을 적용하기 전 테이블의 전체 행 수입니다. 통계가 필터링되지 않으면 unfiltered_rows 행 열의 값 반환과 같습니다. |
| modification_counter | bigint | 통계가 마지막으로 업데이트된 이후 선행 통계 열(히스토그램이 작성된 열)에 대한 총 수정 횟수입니다. 이 열에는 메모리 최적화 테이블에 대한 정보가 포함되어 있지 않습니다. |
설명
sys.dm_db_incremental_stats_properties는 다음과 같은 경우 빈 행 집합을 반환합니다.
object_id또는stats_idNULL입니다.- 지정한 개체를 찾을 수 없거나 증분 통계가 있는 테이블에 해당하지 않습니다.
- 지정한 통계 ID가 특정 개체 ID의 기존 통계에 해당되지 않습니다.
- 현재 사용자에게 통계 개체를 볼 수 있는 권한이 없습니다.
이 동작은 sys.dm_db_incremental_stats_properties 및 sys.objects 와 같은 뷰의 행에 교차 적용될 때 sys.stats를 안전하게 사용할 수 있습니다. 이 메서드는 각 파티션에 해당하는 통계에 대한 속성을 반환할 수 있습니다. 모든 파티션에서 결합된 병합된 통계에 대한 속성을 보려면 대신 sys.dm_db_stats_properties 사용합니다.
통계 업데이트 날짜는 히스토그램 및 밀도 벡터와 함께 메타데이터가 아닌 통계 BLOB 개체에 저장됩니다. 통계 데이터를 생성하기 위해 데이터를 읽지 않으면 통계 Blob이 생성되지 않고 날짜를 사용할 수 없으며 last_updated 열이 NULL입니다. 이 경우는 조건자가 행을 반환하지 않는 필터링된 통계 또는 빈 테이블에 대해 필터링된 통계에 해당하는 경우입니다.
사용 권한
사용자에게 통계 열에 대한 선택 권한이 있거나 사용자가 테이블을 소유하거나 sysadmin 고정 서버 역할, db_owner 고정 데이터베이스 역할 또는 db_ddladmin 고정 데이터베이스 역할의 멤버여야 합니다.
예제
A. 간단한 예
다음 예제에서는 분할된 테이블 및 인덱스 만들기 항목에 설명된 테이블에 대한 PartitionTable 통계를 반환합니다.
SELECT * FROM sys.dm_db_incremental_stats_properties (object_id('PartitionTable'), 1);
추가 사용 제안 사항은 sys.dm_db_stats_properties 참조하세요.
참고 항목
DBCC SHOW_STATISTICS(Transact-SQL)
sys.stats(Transact-SQL)
개체 관련 동적 관리 뷰 및 함수(Transact-SQL)
동적 관리 뷰 및 함수(Transact-SQL)
sys.dm_db_stats_properties
sys.dm_db_stats_histogram (Transact-SQL)