スキーマ:

ACCOUNT_USAGE

WAREHOUSE_EVENTS_HISTORY ビュー

注釈

このビューは 2024_04の動作変更バンドル で一般公開 (GA) されています。GA の機能を使用するには、2024_04動作変更バンドルがアカウントで無効に なっていない ことが必要です。ビューの変更点について詳しくは、 WAREHOUSE_EVENTS_HISTORY ビュー(ACCOUNT_USAGE): 新しい列とイベントへの変更 をご参照ください。

このAccount Usageビューを使用して、過去365日間(1年間)にアカウントの単一クラスターおよび複数クラスターウェアハウスに対してトリガーされたイベントを返すことができます。

サポートされるイベントは次のとおりです。

  • ウェアハウスの作成、削除、または変更(ウェアハウスのサイズ変更を含む)。

  • ウェアハウスの再開または一時停止。

  • ウェアハウス内のクラスターの再開、一時停止、またはサイズ変更(単一クラスターおよびマルチクラスターウェアハウス)。

  • ウェアハウスで追加のクラスターの停止または開始(マルチクラスターウェアハウスのみ)。

列名

データ型

説明

TIMESTAMP

TIMESTAMP_LTZ

イベントがトリガーされたときのタイムスタンプ。

WAREHOUSE_ID

NUMBER

アカウントのウェアハウス名に対応する一意のウェアハウス ID(Snowflakeによる割り当て)。

WAREHOUSE_NAME

VARCHAR

アカウント内のウェアハウスの名前。

CLUSTER_NUMBER

NUMBER

マルチクラスターウェアハウス内の特定のクラスターに対してイベントがトリガーされた場合に、イベントがトリガーされたクラスターの数(1で開始します)。イベントがウェアハウス内のすべてのクラスターに対してトリガーされた場合や単一クラスターのウェアハウスに適用できない場合、NULL が表示されます。

EVENT_NAME

VARCHAR

イベントの名前。可能な値のリストについては、 EVENT_NAME の説明 をご参照ください。

EVENT_REASON

VARCHAR

イベントの原因。可能な値のリストについては、 EVENT_REASON の説明 をご参照ください。

EVENT_STATE

VARCHAR

完了までに時間がかかるイベントの状態。値は STARTED または COMPLETED になります。

USER_NAME

VARCHAR

イベントを開始したユーザー。

ROLE_NAME

VARCHAR

イベント開始時に、セッションでアクティブだったロール。

QUERY_ID

VARCHAR

SQL ステートメントの内部/システム生成識別子。

SIZE

VARCHAR

イベント発生時のウェアハウスの現在のサイズ。この値は WAREHOUSE_CONSISTENT イベントでのみ利用可能です。それ以外の場合、この値は NULL になります。

CLUSTER_COUNT

NUMBER

イベント発生時のウェアハウスのクラスタ数。この値は WAREHOUSE_CONSISTENT イベントでのみ利用可能です。それ以外の場合、この値は NULL になります。

EVENT_NAME の説明

EVENT_REASON の説明

次の表に、 EVENT_REASON 列に対して有効な値を示します。

EVENT_REASON

説明

WAREHOUSE_AUTORESUME

AUTO_RESUME がウェアハウスに対して有効化され、SQL ステートメントがウェアハウスに送信されたため、一時停止中のウェアハウスは自動的に再開されました。

WAREHOUSE_RESUME

一時停止中のウェアハウスが、ユーザーによって手動で再開されました。

WAREHOUSE_AUTOSUSPEND

AUTO_SUSPEND がウェアハウスで有効になっていて、AUTO_SUSPEND の非アクティブの定義された期間が経過したため、実行中のウェアハウスは自動的に一時停止されました。

WAREHOUSE_SUSPEND

稼働中のウェアハウスがユーザーによって手動で一時停止されました。

WAREHOUSE_RESIZE

ウェアハウスのサイズを変更しました。

RESOURCE_MONITOR_SUSPEND

ウェアハウスのリソースモニターのクレジットクォータに達したため、ウェアハウスが一時停止されました。

MULTICLUSTER_SPINUP

新しいクラスターまたは中断されたクラスターがマルチクラスターウェアハウスにプロビジョニングされました。単一クラスターのウェアハウスには適用されません。

MULTICLUSTER_SPINDOWN

実行中のクラスターがマルチクラスターウェアハウスでシャットダウンされました。単一クラスターのウェアハウスには適用されません。

使用上の注意

  • ビューの遅延は最大3時間です。

  • イベントによって関連する追加イベントがトリガーされる場合、ビューに複数の行が生成される場合があります。

  • WAREHOUSE_CONSISTENT イベントの場合、 EVENT_REASON、 USER_NAME、 ROLE_NAME、 QUERY_ID 列の値は NULL になります。

  • WAREHOUSE_CONSISTENT イベントは、別のウェアハウスイベントと同じタイムスタンプを共有し、順番がずれて表示される可能性があります。

処理が完了したことを示すウェアハウスイベント

ウェアハウスを作成したり、ウェアハウスのサイズやクラスタ数を変更したり、ウェアハウスを一時停止したりするイベントは、アトミック操作ではありません。つまり、これらの操作が完全に完了するまでにわずかな時間が必要だということです。

たとえば、 ALTER WAREHOUSE...SUSPEND ステートメントを使用してウェアハウスを一時停止する場合、ウェアハウスで現在実行中のクエリは、一時停止する前に完了(またはタイムアウト)する必要があります。場合によっては、複数のウェアハウスイベントが発生している可能性があります(たとえば、サイズ変更と一時停止)。すべてのウェアハウスイベントが完了すると、ウェアハウスは 一貫した 状態になります。

ウェアハウスイベント を STARTED 状態で EVENT_STATE 列にログ記録する場合、 COMPLETED 状態でログ記録されることはありません。その代わり、 STARTED 状態でログ記録されたイベントの後には、必ず WAREHOUSE_CONSISTENT イベントが続きます。複数のウェアハウスイベントが STARTED イベント状態でログ記録された場合、それらのイベントは同じ WAREHOUSE_CONSISTENT イベントに統合されます。

ウェアハウスイベントが COMPLETED 状態で EVENT_STATE 列にログ記録された場合、保留中の別のイベントが STARTED 状態でログ記録されない限り、 WAREHOUSE_CONSISTENT イベントがそれに続くことはありません。

前週のイベント履歴を表示する

ウェアハウス my_wh の前週のイベント履歴を表示するには、次のステートメントを実行します。

SELECT timestamp, warehouse_name, cluster_number,
       event_name, event_reason, event_state,
       size, cluster_count
  FROM SNOWFLAKE.ACCOUNT_USAGE.WAREHOUSE_EVENTS_HISTORY
  WHERE warehouse_name = 'MY_WH'
  AND timestamp > DATEADD('day', -7, CURRENT_TIMESTAMP())
  ORDER BY timestamp DESC;
Copy

イベント履歴の結果の例

保留中の変更がないステートメントのイベント履歴

ALTER WAREHOUSE ステートメントは、保留中の追加変更がない場合、 COMPLETED 状態でログ記録されます。例えば、次のステートメントはウェアハウス my_wh のコメントを更新します。

ALTER WAREHOUSE my_wh SET
  COMMENT = 'Updated comment for warehouse';
Copy

このステートメントにより、 WAREHOUSE_EVENTS_HISTORY ビューの行は以下のようになります。

TIMESTAMP

WAREHOUSE_NAME

EVENT_NAME

EVENT_STATE

SIZE

CLUSTER_COUNT

2024-04-26 16:42:13.513 +0000

MY_WH

ALTER_WAREHOUSE

COMPLETED

NULL

NULL

後に WAREHOUSE_CONSISTENT イベントが続くステートメントのイベント履歴

ALTER WAREHOUSE ステートメントによってウェアハウスのサイズが変更されると、追加イベントが発生します。例えば、ウェアハウス my_wh のサイズを変更する場合、

ALTER WAREHOUSE my_wh SET
  WAREHOUSE_SIZE = 'SMALL';
Copy

このステートメントにより、 WAREHOUSE_EVENTS_HISTORY ビューの行は以下のようになります。

TIMESTAMP

WAREHOUSE_NAME

EVENT_NAME

EVENT_STATE

SIZE

CLUSTER_COUNT

2024-05-29 15:13:05.874 +0000

MY_WH

ALTER_WAREHOUSE

STARTED

NULL

NULL

2024-05-29 15:13:05.874 +0000

MY_WH

RESIZE_WAREHOUSE

STARTED

NULL

NULL

2024-05-29 15:13:06.036 +0000

MY_WH

WAREHOUSE_CONSISTENT

COMPLETED

SMALL

1

2024-05-29 15:13:06.036 +0000

MY_WH

RESIZE_CLUSTER

COMPLETED

NULL

NULL

Snowflakeが開始したウェアハウスのイベント履歴

Snowflake マルチクラスターウェアハウスを再開すると、以下のウェアハウスイベントがログに記録されます。

TIMESTAMP

WAREHOUSE_NAME

EVENT_NAME

EVENT_STATE

SIZE

CLUSTER_COUNT

2024-04-23 17:04:11.618 +0000

MY_WH

SPINUP_CLUSTER

STARTED

NULL

NULL

2024-04-23 17:04:11.657 +0000

MY_WH

RESUME_CLUSTER

STARTED

NULL

NULL

2024-04-23 17:04:11.657 +0000

MY_WH

WAREHOUSE_CONSISTENT

COMPLETED

LARGE

5