QUERY_ACCELERATION_HISTORY

QUERY_ACCELERATION_HISTORY 함수는 지정된 날짜 범위 내의 쿼리 가속 서비스(query acceleration service) 기록을 조회하는 데 사용돼요. 반환되는 정보에는 주어진 시간대에 웨어하우스 수준에서 쿼리 가속 서비스에 사용된 크레딧(credits)이 포함돼요.

Enterprise Edition 기능: 쿼리 가속 서비스는 Enterprise Edition(또는 그 이상)을 요구해요. 업그레이드에 대해 문의하려면 Snowflake 지원팀에 연락하세요.

참고: 이 함수는 일반적으로 더 완전한 데이터 집합을 제공하고 더 긴 날짜 범위를 지원하는 ACCOUNT_USAGE.QUERY_ACCELERATION_HISTORY 뷰를 위해 폐기(deprecated)되었어요.

출처: 문서

본문

문법 (Syntax)

QUERY_ACCELERATION_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , WAREHOUSE_NAME => '<string>' ] )

파라미터 (Parameters)

모든 인자는 선택적이에요.

DATE_RANGE_START => constant_expr , DATE_RANGE_END => constant_expr — 쿼리 가속 기록을 표시할 날짜/시간 범위예요. 예를 들어 시작 날짜를 2019-05-03, 끝 날짜를 2019-05-05로 지정하면 5월 3일, 5월 4일, 5월 5일의 데이터를 얻어요. (양 끝점이 포함돼요.) 시작 날짜와 끝 날짜를 모두 지정하지 않으면 기본값은 최근 12시간이에요. 끝 날짜를 지정하지 않고 시작 날짜만 지정하면 자정의 CURRENT_DATE가 범위의 끝으로 사용돼요. 시작 날짜를 지정하지 않고 끝 날짜만 지정하면 DATE_RANGE_END의 시작 12시간 전부터 범위가 시작돼요.
WAREHOUSE_NAME => string — 웨어하우스 이름이에요. 지정하면 지정된 웨어하우스의 기록만 표시돼요. 웨어하우스 이름을 지정하지 않으면 결과에 쿼리 가속 서비스를 사용하는 각 웨어하우스의 기록이 포함돼요.

출력 (Output)

이 함수는 다음 열을 반환해요:

열 이름 (Column Name)	데이터 타입 (Data Type)	설명 (Description)
START_TIME	TIMESTAMP_LTZ	서비스가 사용된 지정된 시간 범위의 시작
END_TIME	TIMESTAMP_LTZ	서비스가 사용된 지정된 시간 범위의 끝
CREDITS_USED	NUMBER	서비스가 사용한 크레딧 수
WAREHOUSE_NAME	TEXT	사용이 발생한 웨어하우스의 이름
NUM_FILES_SCANNED	NUMBER	서비스가 스캔한 파일 수
NUM_BYTES_SCANNED	NUMBER	서비스가 스캔한 바이트 수

사용 메모 (Usage notes)

ACCOUNTADMIN 역할 또는 MONITOR USAGE 글로벌 특권을 명시적으로 부여받은 역할에 대해서만 결과를 반환해요.
정보 스키마(Information Schema) 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수 이름이 정규화되어야 해요. 자세한 내용은 Snowflake Information Schema를 참조하세요.

더 알아보기 (Learn more)

정보 스키마 (Information Schema)