- 카테고리:
AUTOMATIC_CLUSTERING_HISTORY¶
이 테이블 함수는 지정된 날짜 범위 내에서 지정된 테이블에 대한 자동 클러스터링 기록을 쿼리하는 데 사용됩니다. 함수가 반환하는 정보에는 테이블이 재클러스터될 때마다 소비된 크레딧, 업데이트된 바이트, 업데이트된 행이 포함됩니다.
구문¶
AUTOMATIC_CLUSTERING_HISTORY(
[ DATE_RANGE_START => <constant_expr> ]
[ , DATE_RANGE_END => <constant_expr> ]
[ , TABLE_NAME => '<string>' ] )
인자¶
모든 인자는 선택 사항입니다.
DATE_RANGE_START => constant_expr
, .DATE_RANGE_END => constant_expr
자동 클러스터링 기록을 표시할 날짜/시간 범위입니다. 예를 들어 시작 날짜를 2019-04-03으로 지정하고 종료 날짜를 2019-04-05로 지정하면 4월 3일, 4월 4일, 4월 5일에 대한 데이터를 가져옵니다. (엔드포인트가 포함됩니다.)
시작 날짜와 종료 날짜가 모두 지정되지 않은 경우, 기본값은 지난 12시간입니다.
종료 날짜는 지정하지 않았지만, 시작 날짜는 지정하는 경우, 자정의 CURRENT_DATE 가 범위의 끝으로 사용됩니다.
시작 날짜는 지정하지 않았지만, 종료 날짜는 지정하는 경우, 범위는
DATE_RANGE_END
시작 12시간 전에 시작됩니다.
TABLE_NAME => string
테이블 이름입니다. 지정된 경우, 지정된 테이블에 대한 기록만 표시합니다. 테이블 이름에는 스키마 이름과 데이터베이스 이름이 포함될 수 있습니다.
테이블 이름을 지정하지 않는 경우, 지정된 시간 범위 내에서 자동 클러스터링 서비스가 유지 관리하는 각 테이블에 대한 기록이 결과에 포함됩니다.
사용법 노트¶
ACCOUNTADMIN 역할에 대한 결과 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대한 결과만 반환합니다.
참고
MONITOR USAGE 권한이 있는 역할은 오브젝트별 크레딧 사용량을 볼 수 있지만, 오브젝트 이름은 볼 수 없습니다. 이 함수가 이름을 반환하려면 해당 역할에는 오브젝트에 대한 SELECT도 부여되어야 합니다. 역할에 오브젝트 이름을 볼 수 있는 충분한 권한이 없는 경우, 오브젝트 이름이 “unknown_#”와 같은 대체 이름으로 표시될 수 있으며, 여기서 “#”는 한 자리 이상의 숫자를 나타냅니다.
Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.
기록은 1시간 단위로 표시됩니다.
출력¶
이 함수는 다음 열을 반환합니다.
열 이름 |
데이터 타입 |
설명 |
---|---|---|
START_TIME |
TIMESTAMP_LTZ |
지정된 시간 범위의 시작입니다. |
END_TIME |
TIMESTAMP_LTZ |
지정된 시간 범위의 끝입니다. |
TABLE_NAME |
TEXT |
테이블의 이름입니다. 함수에 테이블 이름이 지정되지 않은 경우, NULL을 표시합니다. 이 경우, 각 행에는 시간 범위 내에서 사용 중인 모든 테이블의 합계가 포함됩니다. |
CREDITS_USED |
NUMBER |
START_TIME 및 END_TIME 기간 동안 자동 클러스터링에 대해 청구된 크레딧 수입니다. |
NUM_BYTES_RECLUSTERED |
NUMBER |
START_TIME 및 END_TIME 기간 동안 재클러스터된 바이트 수입니다. |
NUM_ROWS_RECLUSTERED |
NUMBER |
START_TIME 및 END_TIME 기간 동안 로딩된 재클러스터된 행 수입니다. |
예¶
계정에 대한 1시간 범위의 자동 클러스터링 기록을 검색합니다.
select * from table(information_schema.automatic_clustering_history( date_range_start=>'2018-04-10 13:00:00.000 -0700', date_range_end=>'2018-04-10 14:00:00.000 -0700'));
계정에 대해 지난 12시간 동안의 자동 클러스터링 기록을 1시간 주기로 검색합니다.
select * from table(information_schema.automatic_clustering_history( date_range_start=>dateadd(H, -12, current_timestamp)));
계정에 대한 지난주의 자동 클러스터링 기록을 검색합니다.
select * from table(information_schema.automatic_clustering_history( date_range_start=>dateadd(D, -7, current_date), date_range_end=>current_date));
계정의 지정된 테이블에 대한 지난주의 자동 클러스터링 기록을 검색합니다.
select * from table(information_schema.automatic_clustering_history( date_range_start=>dateadd(D, -7, current_date), date_range_end=>current_date, table_name=>'mydb.myschema.mytable'));