<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

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

액세스 제어 요구 사항

자세한 내용은 예산 역할 및 권한 섹션을 참조하십시오.

사용법 노트

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

    참고

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

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

  • 이 메서드를 호출해도 오브젝트는 반환되지 않습니다. 이로 인해, 메서드 연결을 사용하여 이 메서드의 반환값으로 다른 메서드를 호출할 수 없습니다. 대신, 별도의 SQL 문에서 각 메서드를 호출합니다.

예

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

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

오류 메시지

이 메서드를 호출할 때 발생할 수 있는 문제를 해결하려면 GET_SERVICE_TYPE_USAGE 메서드를 성공적으로 호출할 수 없습니다. 섹션을 참조하십시오.

언어: 한국어