<budget_name>!GET_SERVICE_TYPE_USAGE

서비스 유형별로 예산 에 대한 크레딧 사용을 확인합니다.

참고 항목:

<budget_name>!GET_SPENDING_HISTORY

구문

<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>
                                    )
Copy

인자

SERVICE_TYPE => service_type

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

유효한 값:

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

  • AUTO_CLUSTERING

  • HYBRID_TABLE_REQUESTS

  • 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

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

반환

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

열 이름

데이터 타입

설명

START_TIME

TIMESTAMP_TZ

사용이 발생한 날짜 및 시간입니다.

ENTITY_ID

NUMBER

예산에 있는 오브젝트의 내부 식별자입니다.

NAME

VARCHAR

측정된 오브젝트의 이름입니다.

CREDITS_USED

FLOAT

사용된 크레딧 수입니다. 이는 CREDITS_COMPUTE 및 CREDITS_CLOUD 의 합계입니다.

CREDITS_COMPUTE

FLOAT

사용된 컴퓨팅 크레딧 수입니다.

CREDITS_CLOUD

FLOAT

사용한 클라우드 서비스 크레딧 수입니다.

액세스 제어 요구 사항

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

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

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

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

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

사용법 노트

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

참고

  • 타임존 이름은 대/소문자를 구분하며 작은따옴표로 묶어야 합니다 (예: 'UTC').

  • 주어진 약어는 여러 가지 다양한 타임존 중 하나를 가리키므로, Snowflake는 대다수 타임존 약어 (예: PDT, EST 등)를 지원하지 않습니다. 예를 들어, CST 는 북미의 중부 표준시(UTC-6), 쿠바 표준시(UTC-5), 중국 표준시(UTC+8)를 가리킬 수 있습니다.

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

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()
);
Copy

오류 메시지

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

오류

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.

원인

TIME_DEPART 인자는 유효하지 않은 문자열입니다.

해결책

에 나열된 유효한 값 중 하나를 사용하십시오.

오류

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

원인

USER_TIMEZONE 인자는 유효하지 않은 문자열입니다.

해결책

유효한 타임존 문자열을 사용하십시오. 자세한 내용은 위의 사용법 노트 를 참조하십시오.