<budget_name>!GET_SERVICE_TYPE_USAGE¶

구문¶

<budget_name>!GET_SERVICE_TYPE_USAGE( SERVICE_TYPE => '<service_type>' ,
                                      TIME_DEPART => '<time_interval>' ,
                                      USER_TIMEZONE => '<timezone>' ,
                                      TIME_LOWER_BOUND => <constant_expr> ,
                                      TIME_UPPER_BOUND => <constant_expr>
                                    )

인자¶

SERVICE_TYPE => service_type

결과를 제한하는 데 사용되는 서비스 유형입니다.

유효한 값:

크레딧을 소비하는 서비스 유형 으로, 다음 중 하나일 수 있습니다.

• AUTO_CLUSTERING

• MATERIALIZED_VIEW

• PIPE

• QUERY_ACCELERATION

• SEARCH_OPTIMIZATION

• SERVERLESS_TASK

• SNOWPIPE_STREAMING

• WAREHOUSE_METERING

• WAREHOUSE_METERING_READER

TIME_DEPART => time_interval

사용 레코드를 기술하는 데 사용되는 시간 간격입니다. 각 행에는 지정된 시간 간격으로 서비스 사용량이 표시됩니다.

유효한 값:

• HOUR, 시간

• DAY, 일

• WEEK, 주

USER_TIMEZONE => timezone

사용자의 타임존을 지정하는 문자열입니다. 예산 측정은 UTC 타임존을 기준으로 합니다.

TIME_LOWER_BOUND => constant_expr

지출이 발생한 시간 범위의 시작입니다.

TIME_UPPER_BOUND => constant_expr

지출이 발생한 시간 범위의 끝입니다.

반환¶

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

액세스 제어 요구 사항¶

• 사용자 지정 예산 결과를 보려면 다음과 같은 최소 권한과 역할이 필요합니다.

  • 예산 인스턴스에 대한 인스턴스 역할 이 있는 역할.

  • 예산 인스턴스가 포함된 데이터베이스와 스키마에 대한 USAGE 권한이 부여된 역할.

• 계정 예산 결과를 보려면 다음 역할이 필요합니다.

  계정 예산에 대한 애플리케이션 역할 이 있는 역할.

사용법 노트¶

timezone 의 경우 IANA 타임존 데이터베이스 의 릴리스 2021a 에서 타임존 이름 또는 링크 이름 을 지정할 수 있습니다(예: America/Los_Angeles, Europe/London, UTC, Etc/GMT 등).

예¶

계정 예산에 대해 지난주 각 웨어하우스에 지출된 일일 크레딧을 확인합니다.

CALL snowflake.local.account_root_budget!GET_SERVICE_TYPE_USAGE(
   SERVICE_TYPE => 'WAREHOUSE_METERING',
   TIME_DEPART => 'day',
   USER_TIMEZONE => 'UTC',
   TIME_LOWER_BOUND => dateadd('day', -7, current_timestamp()),
   TIME_UPPER_BOUND => current_timestamp()
);

오류 메시지¶

다음 시나리오는 발생할 수 있는 문제를 해결하는 데 도움이 될 수 있습니다.

001044 (42P13): SQL compilation error: error line 0 at position -1
Invalid argument types for function 'GET_SERVICE_TYPE_USAGE':
(VARCHAR(X), VARCHAR(X), VARCHAR(X), VARCHAR(X))

002151 (22023): Uncaught exception of type 'STATEMENT_ERROR' on line 16
at position 23 : SQL compilation error: [:TIME_DEPART] is not a valid
date/time component for function DATE_TRUNC.

100094 (22000): Uncaught exception of type 'STATEMENT_ERROR' on line 16
at position 23 : Unknown timezone: '<invalid_timezone>'