적용 대상:
데이터브릭 완료 데이터브릭스 런타임 19 이상
델타 레이크 또는 관리형 아파치 아이스버그 테이블의 각 잎 열마다 한 행씩 반환합니다. 각 행은 해당 열이 데이터 건너뛰기 대상인지 여부와 현재 스냅샷에서 해당 열의 최소 및 최대 통계가 포함된 파일의 비율을 보고합니다.
이 함수는 테이블 로그를 읽고 데이터 파일을 스캔하지 않습니다.
Requirements
이 기능을 발동하려면 테이블 위에 있는 특권을 가져 SELECT 야 합니다.
Syntax
data_skipping_summary( TABLE ( table_name ) )
Arguments
table_name: 테이블을 지정하는 3부분 식별자입니다.
이 함수는 다음과 같은 테이블 유형을 지원합니다:
- 관리 및 외부 델타 레이크 테이블
- Iceberg 읽기 활성화된 관리 Apache Iceberg 테이블과 Delta Lake 테이블
- 스트리밍 테이블
- 머티리얼라이즈드 뷰
- 관리형 및 외부 얕은 클론
이 함수는 메트릭 뷰, 외래 테이블, 뷰를 지원하지 않습니다.
Returns
이 함수는 다음 열을 반환합니다:
-
column_name STRING NOT NULL: 논리 열의 이름입니다. 중첩된 구조체 필드는 점선을 사용하며, 예를address.street들어 . -
data_type STRING NOT NULL: Spark SQL 데이터 타입, .와 같은DESCRIBE TABLE형식입니다. -
is_partition_column BOOLEAN NOT NULL:true열이 테이블의 파티션 명세의 일부라면 -
is_clustering_column BOOLEAN NOT NULL:true열이 액체 군집 키라면 -
data_skipping_eligible BOOLEAN NOT NULL:true테이블이 해당 열의 통계를 건너뛰는 데이터를 수집한다면. -
data_skipping_excluded_reason STRING: 열이 데이터 건너뛰기 대상이 아닌 이유. 가치는 해당 열이 자격이 될 때입니다NULL. 그렇지 않으면 값은 다음 중 하나입니다:-
IS_PARTITION_COLUMN: 이 열은 분할 열입니다. 파티션 컬럼은 별도의 데이터 건너뛰기 메커니즘을 사용합니다. -
NOT_IN_INDEXED_COLUMN_SET: 해당 열은 통계 수집에 맞게 설정되어 있지 않습니다. -
TYPE_NOT_ELIGIBLE: 열의 데이터 타입은 통계 건너뛰기를 지원하지 않습니다.
-
-
stats_coverage_pct DOUBLE: 테이블의 현재 스냅샷에서 열의0.0100.0최소 및 최대 통계를 포함하는 파일 비율, 즉 . 가치는 해당 열이 자격이 없을 때입니다NULL.
MAP 컬럼, ARRAY 컬럼, STRUCT 컨테이너는 데이터 건너뛰기 통계 대상이 아닙니다. a STRUCT 내의 잎들은 별도로 평가됩니다.
열은 VARIANT 한 잎 열로 보고됩니다. 통계 건너뛰는 변이형 데이터가 수집되어야 자격이 됩니다. 함수는 하위 경로(subpath)를 나열 VARIANT 하지 않습니다.
Examples
> SELECT * FROM data_skipping_summary(TABLE(my_catalog.my_schema.events));
column_name data_type is_partition_column is_clustering_column data_skipping_eligible data_skipping_excluded_reason stats_coverage_pct
----------- ------------------- ------------------- -------------------- ---------------------- ----------------------------- ------------------
event_date date true false false IS_PARTITION_COLUMN null
event_type string false false true null 98.0
user_agent string false false false NOT_IN_INDEXED_COLUMN_SET null
metadata map<string,string> false false false TYPE_NOT_ELIGIBLE null