ANOMALY_INSIGHTS!GET_HOURLY_CONSUMPTION_BY_SERVICE_TYPE

特定の日における現在のアカウントの1時間ごとの消費量をサービスタイプ別に返します。オプションで、その日に最も多くのクレジットを消費しているサービスタイプのみに結果を絞り込むことができます。

構文

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 アプリケーションロール

使用上の注意

  • 1日とは、UTC における24時間の期間を指します。これはユーザーのローカルタイムゾーンと異なる場合があります。

  • このメソッドは、現在のアカウントの消費データを返します。他のアカウントや組織全体のデータを返すために使用することはできません。

  • このメソッドは、アカウントで消費されたクレジット（通貨ではありません）を返します。

  • 上位のサービスタイプは、1日全体の総消費量に基づいて決定されます。上位のサービスタイプが特定された後、メソッドはそれらの各サービスタイプの時間単位の消費量を返します。

例

2026年1月15日に最も多くのクレジットを消費した2つのサービスタイプを返します。出力には、各サービスタイプの時間ごとの消費量が含まれます。

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

2026年1月15日に消費があったすべてのサービスタイプについて、その日の1時間ごとの消費量を返します。

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