카테고리:

Information Schema , 테이블 함수

WAREHOUSE_LOAD_HISTORY

이 테이블 함수는 지정된 날짜 범위 내의 단일 웨어하우스에 대한 활동 기록(《쿼리 로딩》으로 정의됨)을 쿼리하는 데 사용할 수 있습니다.

참고

이 함수는 지난 14일 이내의 웨어하우스 활동을 반환합니다.

참고

현재 타임스탬프에서 1분 이내의 날짜 값을 지정하면 부정확한 결과가 생성될 수 있습니다.

참고 항목:

WAREHOUSE_METERING_HISTORY

구문

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

인자

모든 인자는 선택 사항입니다.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

웨어하우스 로딩 기록 데이터를 검색할 지난 14일 이내의 날짜 범위:

  • 종료 날짜가 지정되지 않은 경우, CURRENT_DATE 가 범위의 끝으로 사용됩니다.

  • 시작 날짜가 지정되지 않은 경우, 범위는 DATE_RANGE_END 시작 10분 전에 시작됩니다(즉, 기본값은 이전 10분의 로딩 기록을 표시하는 것입니다). 예를 들어 DATE_RANGE_ENDCURRENT_DATE 인 경우, 기본 DATE_RANGE_START전날 오후 11시 50분입니다.

범위가 지난 15일을 벗어나면 오류가 반환됩니다.

참고

선택한 기간이 8시간 미만인 경우, 로딩이 5초 간격으로 표시됩니다. 그렇지 않으면 5분 간격이 사용됩니다.

WAREHOUSE_NAME => 'string'

사용 로딩 기록을 검색할 웨어하우스의 이름입니다. 웨어하우스 이름은 작은따옴표로 묶어야 합니다. 또한, 웨어하우스 이름에 공백, 대/소문자 혼합 문자 또는 특수 문자가 포함된 경우, 이름을 작은따옴표 안에 큰따옴표로 묶어야 합니다(예: '"My Warehouse"' vs 'mywarehouse').

기본값: CURRENT_WAREHOUSE

사용법 노트

  • 이 함수에서 결과를 얻으려면 다음 역할 또는 권한 중 하나가 필요합니다.

    • ACCOUNTADMIN 역할은 모든 전역 계정 권한을 가지고 있으므로 이 함수에서 결과를 얻을 수 있습니다.

    • ACCOUNT에 대한 MONITOR USAGE 전역 권한이 있는 역할은 계정의 모든 웨어하우스에 대해 이 함수를 쿼리할 수 있습니다.

    • WAREHOUSE에 대한 MONITOR 권한이 있는 역할은 권한이 있는 웨어하우스에 대해 이 함수를 쿼리할 수 있습니다.

    • WAREHOUSE에 대한 OWNERSHIP 권한이 있는 역할은 MONITOR를 포함하여 웨어하우스에 대한 모든 권한을 가집니다.

    자세한 내용은 액세스 제어 권한 섹션을 참조하십시오.

  • Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

출력

참고

이 함수의 출력 열의 경우, 쿼리 로드 값은 어떤 간격에서 특정 상태에 있는 모든 쿼리의 총 실행 시간(초)을 그 간격의 총 시간(초)으로 나눈 비율입니다.

예를 들어 5분(300초) 간격에서 4개 쿼리의 총 시간이 276초라면 쿼리 로드 값은 276 / 300 = 0.92입니다.

이 함수는 다음 열을 반환합니다.

열 이름

데이터 타입

설명

START_TIME

TIMESTAMP_LTZ

웨어하우스 사용이 발생한 지정된 시간 범위(UTC 타임존)의 시작입니다.

END_TIME

TIMESTAMP_LTZ

웨어하우스 사용이 발생한 지정된 시간 범위(UTC 타임존)의 끝입니다.

WAREHOUSE_NAME

TEXT

웨어하우스의 이름입니다.

AVG_RUNNING

NUMBER(38,2)

실행된 쿼리의 쿼리 로드 값입니다.

AVG_QUEUED_LOAD

NUMBER(38,2)

웨어하우스가 오버로드되었기 때문에 큐에 있는 쿼리의 쿼리 로드 값입니다.

AVG_QUEUED_PROVISIONING

NUMBER(38,2)

웨어하우스가 프로비저닝되었기 때문에 큐에 있는 쿼리의 쿼리 로드 값입니다.

AVG_BLOCKED

NUMBER(38,2)

트랜잭션 잠금으로 차단된 쿼리의 쿼리 로드 값입니다.

세션에 현재 사용 중인 웨어하우스에 대한 지난 1시간 동안의 로딩 기록을 5초 간격으로 검색합니다.

use warehouse mywarehouse;

select *
from table(information_schema.warehouse_load_history(date_range_start=>dateadd('hour',-1,current_timestamp())));
Copy

세션에 현재 사용 중인 웨어하우스에 대한 지난 14일 동안의 로딩 기록을 5분 간격으로 검색합니다.

use warehouse mywarehouse;

select *
from table(information_schema.warehouse_load_history(date_range_start=>dateadd('day',-14,current_date()), date_range_end=>current_date()));
Copy