.show extents
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer
참고 항목
데이터 분할된 데이터베이스를 익스텐트라고 하며 모든 명령은 동의어로 "익스텐트" 또는 "익스텐트"를 사용합니다. 익스텐트에 대한 자세한 내용은 익스텐트(데이터 분할된 데이터베이스) 개요를 참조 하세요.
명령 유형 .show extents 은 다음과 같습니다.
참고 항목
이 .show extents 명령은 범위(예: 데이터베이스 또는 클러스터)에서 실행되는 경우 많은 리소스를 사용할 수 있습니다. 가능한 가장 낮은 범위에서 명령 변형을 사용하는 것이 좋습니다. 테이블 범위는 데이터베이스 범위 및 클러스터 범위보다 데이터베이스 범위보다 선호됩니다. 필터링 익스텐트 포함 명령 변형은 다른 쿼리를 사용하여 명령의 결과를 필터링하는 것이 좋습니다.
사용 권한
클러스터에서 익스텐트 표시를 하려면 권한이 있어야 합니다 AllDatabasesMonitor .
데이터베이스의 익스텐트를 보려면 사용 권한이 있어야 합니다Database UserDatabase ViewerDatabase Monitor.
자세한 내용은 역할 기반 액세스 제어를 참조하세요.
테이블 범위
구문
지정된 테이블에 있는 익스텐트(데이터 분할된 데이터베이스)에 대한 정보를 표시합니다. 데이터베이스는 명령의 컨텍스트에서 가져옵니다.
지정된 경우 hot 핫 캐시에 있을 것으로 예상되는 익스텐트만 표시합니다.
.showtable TableName extents [( ExtentId [, ...])] [hot] [where tags (has||!contains!has|contains) TagName [and tags (has!has|!contains||contains) TagName [, ...]]]
.showtables (TableName [, ...]) extents [( ExtentId [, ...])] [hot] [where tags (has||!contains!has|contains) TagName [and tags (has!has|!contains||contains) TagName [, ...]]]
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| TableName | string |
✔️ | 테이블의 이름입니다. |
| ExtentId | string |
표시할 익스텐트 ID입니다. | |
| Tag | string |
지정된 대로 필터링할 태그의 이름입니다. |
권장 사항
- 명령에서 기본 제공 필터링 기능을 사용하는 것이 쿼리 기반 필터 추가(예: 추가
| where DatabaseName == '...'및TableName == '...')를 추가하는 대신 선호됩니다. - 선택적 익스텐트 ID 목록을 제공하는 경우 반환된 데이터 세트는 해당 익스텐트만 제한됩니다.
- 이 메서드는 "bare" 명령의 결과에 필터링(추가
| where ExtentId in(...))보다 빠릅니다.
- 이 메서드는 "bare" 명령의 결과에 필터링(추가
- 필터가 지정된 경우
tags:- 반환된 목록은 태그 컬렉션이 제공된 모든 태그 필터를 준수하는 범위로 제한됩니다.
- 이 메서드는 "bare" 명령의 결과를 필터링(추가
| where Tags has '...' and Tags contains '...')하는 것보다 빠릅니다. has필터는 같음 필터입니다. 지정된 태그 중 하나를 사용하여 태그가 지정되지 않은 익스텐트도 필터링됩니다.!has필터는 같음 음수 필터입니다. 지정된 태그 중 하나를 사용하여 태그가 지정된 익스텐트에서 필터링됩니다.contains필터는 대/소문자를 구분하지 않는 부분 문자열 필터입니다. 지정된 문자열이 태그의 부분 문자열로 없는 익스텐트는 필터링됩니다.!contains필터는 대/소문자를 구분하지 않는 부분 문자열 음수 필터입니다. 지정된 문자열을 태그의 부분 문자열로 포함하는 익스텐트는 필터링됩니다.
데이터베이스 범위
지정된 데이터베이스에 있는 익스텐트(데이터 분할된 데이터베이스)에 대한 정보를 표시합니다.
지정된 경우 hot - 핫 캐시에 있을 것으로 예상되는 익스텐트만 표시합니다.
구문
.showdatabase DatabaseName extents [( ExtentId [, ...])] [hot] [where tags (has||!contains!has|contains) TagName [and tags (has!has|!contains||contains) TagName [, ...]]]
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| DatabaseName | string |
✔️ | 데이터베이스의 이름입니다. |
| ExtentId | string |
표시할 익스텐트 ID입니다. | |
| Tag | string |
지정된 대로 필터링할 태그의 이름입니다. |
클러스터 범위
구문
.showcluster extents [hot]
구문 규칙에 대해 자세히 알아봅니다.
클러스터에 있는 익스텐트(데이터 분할된 데이터베이스)에 대한 정보를 표시합니다.
지정된 경우 hot - 핫 캐시에 있을 것으로 예상되는 익스텐트만 표시합니다.
반품
| 출력 매개 변수 | Type | 설명 |
|---|---|---|
| ExtentId | guid |
익스텐트 ID |
| DatabaseName | string |
범위가 속한 데이터베이스입니다. |
| TableName | string |
범위가 속한 테이블입니다. |
| MaxCreatedOn | datetime |
익스텐트 생성 날짜입니다. 병합된 익스텐트인 경우 원본 익스텐트 간의 최대 생성 시간입니다. |
| OriginalSize | Double | 익스텐트 데이터의 원래 크기(바이트)입니다. |
| ExtentSize | Double | 메모리의 익스텐트 크기(압축 + 인덱스)입니다. |
| CompressedSize | Double | 메모리에 있는 익스텐트 데이터의 압축된 크기입니다. |
| IndexSize | Double | 익스텐트 데이터의 인덱스 크기입니다. |
| 블록 | long |
범위 내의 데이터 블록 수입니다. |
| 세그먼트 | long |
익스텐트 내의 데이터 세그먼트 수입니다. |
| ExtentContainerId | string |
익스텐트 컨테이너의 ID입니다. |
| RowCount | long |
익스텐트 내의 행 수입니다. |
| MinCreatedOn | datetime |
익스텐트 생성 날짜입니다. 병합된 익스텐트에서 원본 익스텐트 간의 최소 생성 시간입니다. |
| 태그 | string |
익스텐트용으로 정의된 태그(있는 경우)입니다. |
| 종류 | string |
익스텐트 생성 스토리지 엔진의 종류입니다. |
| DeletedRowCount | long |
익스텐트에서 삭제된 행의 수입니다. |
예제
태그가 지정된 익스텐트
테이블 T 의 익스텐 E 트에 태그가 지정되고 태그BBB가 지정됩니다.aaaccc
이 쿼리는 다음을 반환합니다.
E.show table T extents where tags has 'aaa' and tags contains 'bb'다음으로 태그가 지정되지 않았으므로 이 쿼리는
aa반환E되지 않습니다..show table T extents where tags has 'aa' and tags contains 'bb'이 쿼리는 다음을 반환합니다.
E.show table T extents where tags contains 'aaa' and tags contains 'bb'
만든 익스텐트 볼륨 표시
특정 데이터베이스에서 시간당 생성되는 익스텐트 볼륨 표시
.show database MyDatabase extents | summarize count(ExtentId) by MaxCreatedOn bin=time(1h) | render timechart
시간당 테이블별로 도착하는 데이터 볼륨 표시
.show database MyDatabase extents
| summarize sum(OriginalSize) by TableName, MaxCreatedOn bin=time(1h)
| render timechart
테이블별 데이터 크기 분포 표시
.show database MyDatabase extents | summarize sum(OriginalSize) by TableName
'GamesDB'라는 데이터베이스의 모든 익스텐트 표시
.show database GamesDB extents
'Games'라는 테이블의 모든 익스텐트 표시
.show table Games extents
특정 테이블의 모든 익스텐트 표시
'tag1' 및 'tag2'로 태그가 지정된 'TaggingGames1' 및 'TaggingGames2'라는 테이블의 모든 익스텐트 표시
.show tables (TaggingGames1,TaggingGames2) extents where tags has 'tag1' and tags has 'tag2'