WAREHOUSE_METERING_HISTORY

WAREHOUSE_METERING_HISTORY

이 테이블 함수는 쿼리에서 지정된 날짜 범위 내의 단일 웨어하우스(또는 계정의 모든 웨어하우스)에 대한 시간별 크레딧 사용량을 반환하는 데 사용할 수 있어요.

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

참고: 이 함수는 Adaptive Warehouse에 대한 크레딧 사용량을 포함하지 않아요. Adaptive Warehouse 사용량을 보려면 ACCOUNT_USAGE.WAREHOUSE_METERING_HISTORY 뷰를 사용하세요.

출처: Snowflake SQL Reference - WAREHOUSE_METERING_HISTORY

본문

구문

WAREHOUSE_METERING_HISTORY(
      DATE_RANGE_START = constant_expr
      [ , DATE_RANGE_END = constant_expr ]
      [ , WAREHOUSE_NAME = string ] )

인자

필수:

DATE_RANGE_START = constant_expr 웨어하우스 사용량이 반환되는 최근 6개월 이내의 시작 날짜예요.

선택:

DATE_RANGE_END = constant_expr 웨어하우스 사용량이 반환되는 최근 6개월 이내의 종료 날짜예요.

기본값: CURRENT_DATE가 사용돼요.

WAREHOUSE_NAME = string 크레딧 사용량을 검색할 웨어하우스의 이름이에요. 웨어하우스 이름은 작은따옴표로 묶어야 해요. 또한 웨어하우스 이름에 공백, 대소문자가 섞인 문자 또는 특수 문자가 포함되어 있으면 이름을 작은따옴표 안에서 큰따옴표로 묶어야 해요(예: My Warehouse vs mywarehouse).

기본값: 지정된 날짜 범위 동안 실행된 모든 웨어하우스.

사용 시 유의사항

• ACCOUNTADMIN 역할 또는 MONITOR USAGE 전역 권한을 명시적으로 부여받은 역할에 대해서만 결과를 반환해요.
• Information Schema 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수 이름이 정규화되어야 해요. 자세한 내용은 Snowflake Information Schema를 참고하세요.
• 인자의 순서와 구조는 인자 키워드(예: DATE_RANGE_START)가 포함되는지에 따라 달라져요:
  • 인자가 순서대로 지정되면 키워드는 필요하지 않아요.
  • 인자 키워드가 포함되면 인자를 어떤 순서로든 지정할 수 있어요.

출력

이 함수는 WAREHOUSE_NAME과 START_TIME 순으로 정렬된 다음 컬럼을 반환해요:

예시

이 시간 동안 실행된 모든 웨어하우스에 대해 지난 10일의 시간별 웨어하우스 사용량을 검색해요:

select *
from table(information_schema.warehouse_metering_history(dateadd(days,-10,current_date())));

지정된 날짜에 testingwh 웨어하우스의 시간별 웨어하우스 사용량을 검색해요:

select *
from table(information_schema.warehouse_metering_history(2017-10-23, 2017-10-23, testingwh));

더 알아보기 (Learn more)

• WAREHOUSE_LOAD_HISTORY — 웨어하우스 로드 기록