- スキーマ:
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;
イベント履歴の結果の例¶
保留中の変更がないステートメントのイベント履歴¶
ALTER WAREHOUSE ステートメントは、保留中の追加変更がない場合、 COMPLETED 状態でログ記録されます。例えば、次のステートメントはウェアハウス my_wh
のコメントを更新します。
ALTER WAREHOUSE my_wh SET
COMMENT = 'Updated comment for warehouse';
このステートメントにより、 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';
このステートメントにより、 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 |