ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE

특정 날짜에 현재 계정의 시간당 사용량을 서비스 유형별로 분류하여 반환합니다. 선택적으로 해당 날짜에 가장 많은 크레딧을 사용하는 서비스 유형으로 결과를 제한할 수 있습니다.

구문

SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE(
  '<date>',
  <number_of_types> )

인자

'date'

소비 데이터를 반환할 요일을 지정합니다.

데이터 타입: DATE

number_of_types

반환할 서비스 유형의 수를 지정하며, 지정된 날짜의 총 사용량을 기준으로 순위가 매겨집니다.

지정된 날짜에 크레딧을 사용한 모든 서비스 유형을 반환하려면 ``NULL``을 지정합니다.

데이터 타입: NUMBER

출력

다음 열이 포함된 테이블을 반환합니다.

열 이름

데이터 타입

설명

HOUR

NUMBER

하루 중 사용이 발생한 시간을 지정하는 0에서 23(포함) 사이의 숫자입니다.

SERVICE_TYPE

VARCHAR

크레딧을 사용한 서비스 유형(예: AI_SERVICES)입니다.

CREDITS

NUMBER

지정된 시간 동안 서비스 유형에서 사용한 크레딧 수입니다.

액세스 제어 요구 사항

다음 역할 중 하나를 가진 사용자는 이 메서드를 호출할 수 있습니다.

  • ACCOUNTADMIN 시스템 역할

  • GLOBALORGADMIN 시스템 역할

  • SNOWFLAKE.APP_USAGE_ADMIN 애플리케이션 역할

  • SNOWFLAKE.APP_USAGE_VIEWER 애플리케이션 역할

사용법 노트

  • 하루는 UTC 에서 24시간 기간으로 정의됩니다. 이는 사용자의 현지 타임존과 다를 수 있습니다.

  • 이 메서드는 현재 계정에 대한 소비 데이터를 반환합니다. 다른 계정이나 전체 조직에 대한 데이터를 반환하는 데는 사용할 수 없습니다.

  • 이 방법은 계정에 소비된 크레딧을 반환합니다(통화가 아님).

  • 상위 서비스 유형은 하루 종일 총 사용량에 따라 결정됩니다. 상위 서비스 유형이 식별된 후 메서드는 해당 서비스 유형 각각에 대한 시간당 사용량을 반환합니다.

예

2026년 1월 15일에 가장 많은 크레딧을 사용한 두 가지 서비스 유형을 반환합니다. 출력에는 각 서비스 유형에 대한 시간당 사용량이 포함됩니다.

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE(
  '2026-01-15', 2);

해당 날짜에 사용량이 있었던 모든 서비스 유형에 대해 2026년 1월 15일의 시간당 사용량을 반환합니다.

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE(
  '2026-01-15',
  NULL);