スキーマ：: ORGANIZATION_USAGE

WAREHOUSE_EVENTS_HISTORY ビュー¶

重要

この表示は組織アカウントでのみ利用可能です。詳細については、組織アカウントのプレミアムビューをご参照ください。

このOrganization Usageビューは、アカウント内の単一クラスターおよびマルチクラスターウェアハウスでトリガーされたイベントを返すために使用できます。

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

ウェアハウスの作成、削除、または変更（ウェアハウスのサイズ変更を含む）。
ウェアハウスの再開または一時停止。
ウェアハウス内のクラスターの再開、一時停止、またはサイズ変更（単一クラスターおよびマルチクラスターウェアハウス）。
ウェアハウスで追加のクラスターの停止または開始（マルチクラスターウェアハウスのみ）。

列¶

組織レベルの列

列名	データ型	説明
ORGANIZATION_NAME	VARCHAR	組織の名前。
ACCOUNT_LOCATOR	VARCHAR	システムが生成したアカウントの識別子。
ACCOUNT_NAME	VARCHAR	ユーザー定義のアカウント識別子。

追加列

列名	データ型	説明
TIMESTAMP	TIMESTAMP_LTZ	イベントがトリガーされたときのタイムスタンプ。
WAREHOUSE_ID	NUMBER	アカウントのウェアハウス名に対応する一意のウェアハウス ID（Snowflakeによる割り当て）。
WAREHOUSE_NAME	VARCHAR	アカウント内のウェアハウスの名前。
CLUSTER_NUMBER	NUMBER	マルチクラスターウェアハウス内の特定のクラスターに対してイベントがトリガーされた場合に、イベントがトリガーされたクラスターの数（1で開始します）。イベントがウェアハウス内のすべてのクラスターに対してトリガーされた場合や単一クラスターのウェアハウスに適用できない場合、NULL が表示されます。
EVENT_NAME	VARCHAR	イベントの名前。可能な値のリストについては、以下をご参照ください。
EVENT_REASON	VARCHAR	イベントの原因。可能な値のリストについては、以下をご参照ください。
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 になります。
WAREHOUSE_TYPE	VARCHAR	`STANDARD` の1つ、または `SNOWPARK-OPTIMIZED`。この値は WAREHOUSE_CONSISTENT イベントでのみ利用可能です。それ以外の場合、この値は NULL になります。
RESOURCE_CONSTRAINT	VARCHAR	次のいずれかです: . - `STANDARD_GEN_1` . - `STANDARD_GEN_2` . - `MEMORY_1X` . - `MEMORY_1X_x86` . - `MEMORY_16X` . - `MEMORY_16X_x86` . - `MEMORY_64X` . - `MEMORY_64X_x86` . この値は WAREHOUSE_CONSISTENT イベントでのみ利用可能です。それ以外の場合、この値は NULL になります。また、 STANDARD_GEN_2機能のリリース前に作成された標準ウェアハウスについては NULL です。

EVENT_NAME の説明¶

以下のセクションでは、ウェアハウス関連イベントおよびクラスタ関連イベントの EVENT_NAME 列の有効な値について説明します。

ウェアハウス関連のイベント:¶

次の表に、ウェアハウス関連イベントの EVENT_NAME 列に対して有効な値を示します。

EVENT_NAME

説明

CONVERT_WAREHOUSE

ウェアハウスを標準からSnowpark用に最適化されたものに、Snowpark用に最適化されたものから標準に、Gen1からGen2に、またはGen2からGen1に変換することでトリガーされます。このイベントは、変換が発生したときにウェアハウスが実行中か一時停止中かに関係なく発生します。

クラスター番号	なし(該当なし)
イベントの状態	COMPLETED または STARTED
イベントの理由	CONVERT_TO_SNOWPARK_OPTIMIZED 、 CONVERT_TO_STANDARD 、または CONVERT_RESOURCE_CONSTRAINT

コストへの影響:新しく追加されたリソースは、プロビジョニングされた時点で計測を開始します。削除されたリソースは、現在実行中のクエリの処理が終了すると、計測を停止します。

Tip

RESOURCE_CONSTRAINT プロパティの変更によるコストへの影響については、 :ref:`ウェアハウスの稼働中または一時停止中の RESOURCE_CONSTRAINT の変更に関する考慮事項 <label-gen_2_standard_warehouses_altering>`をご参照ください。

CREATE_WAREHOUSE

新しいウェアハウスの作成によってトリガーされます。これは、ユーザーが手動でウェアハウスを作成した場合、またはアカウントがプロビジョニングされ、デフォルトのウェアハウスがアカウントに自動的に作成された場合に発生する可能性があります。

クラスター番号	なし(該当なし)
イベントの状態	COMPLETED または STARTED
イベントの理由	なし(該当なし)

コストへの影響:それ以外の場合、計測は、すべてのコンピューティングリソースがウェアハウスにプロビジョニングされるか、ウェアハウスがステートメントの処理を開始したときに開始されます(リソースが完全にプロビジョニングされる前に、ウェアハウスがステートメントの処理を開始した場合)。

DROP_WAREHOUSE

既存のウェアハウスが削除されたときにトリガーされます。ウェアハウスで実行中のすべてのクエリが停止し、コンピューティングリソースが解放されます。

クラスター番号	なし(該当なし)
イベントの状態	COMPLETED または STARTED
イベントの理由	なし(該当なし)

コストへの影響: 実行中のすべてのクエリが完了すると、ウェアハウスのコンピューティングリソースの計測が停止します。

ALTER_WAREHOUSE

ウェアハウスのサイズ変更など、既存のウェアハウスのプロパティが変更されたときにトリガーされます。ウェアハウスのサイズが変更されると、追加の RESIZE_WAREHOUSE イベントがトリガーされます。このイベントは、 RESUME_WAREHOUSE または SUSPEND_WAREHOUSE イベントをトリガーすることもできます。

クラスター番号	なし(該当なし)
イベントの状態	COMPLETED または STARTED
イベントの理由	なし(該当なし)

コストへの影響: ALTER ステートメントによってトリガーされるイベントによって異なります。

RESIZE_WAREHOUSE

ウェアハウスのサイズを変更することでトリガーされ、ウェアハウス内の各クラスターのコンピューティングリソースが増減します。実行中のウェアハウスの場合、このイベントはウェアハウス内の各クラスターに対して RESIZE_CLUSTER イベントもトリガーします。

クラスター番号	なし(該当なし)
イベントの状態	STARTED
イベントの理由	WAREHOUSE_RESIZE

一時停止中のウェアハウスのサイズを変更しても、ウェアハウスに新しいリソースはプロビジョニングされません。

RESUME_WAREHOUSE

一時停止されたウェアハウスが再開されるか、新しいウェアハウスが INITIALLY_SUSPENDED = FALSE で作成されたときにトリガーされます。このイベントは、ウェアハウス内の各クラスターに対して RESUME_CLUSTER イベントもトリガーします。

クラスター番号	なし(すべてのクラスターに適用)
イベントの状態	STARTED
イベントの理由	WAREHOUSE_AUTORESUME または WAREHOUSE_RESUME

コストへの影響: ウェアハウスにすべてのコンピュートリソースがプロビジョニングされた後に計測が開始されます。

SUSPEND_WAREHOUSE

実行中のウェアハウスが一時停止したときにトリガーされます。このイベントは、ウェアハウス内の各クラスターに対して SUSPEND_CLUSTER イベントもトリガーします。

クラスター番号	なし(すべてのクラスターに適用)
イベントの状態	STARTED
イベントの理由	WAREHOUSE_AUTOSUSPEND または WAREHOUSE_SUSPEND

コストへの影響: 実行中のすべてのステートメントが完了すると、ウェアハウスのコンピューティングリソースの計測が停止します。

WAREHOUSE_CONSISTENT

ウェアハウスに対する保留中の変更が完了するとトリガーされます。詳細については、使用上の注意をご参照ください。

クラスター番号	NULL
イベントの状態	COMPLETED
イベントの理由	NULL

コストへの影響:WAREHOUSE_CONSISTENT イベントの前に STARTED 状態で記録されたウェアハウスイベントに対して計測が行われます。

詳しくは、前の行で説明しているウェアハウスイベントのコストへの影響をご参照ください。

クラスター関連のイベント¶

次の表に、クラスター関連イベントの EVENT_NAME 列に対して有効な値を示します。

EVENT_NAME

説明

CONVERT_CLUSTER

ウェアハウスを標準からSnowpark用に最適化されたものに、またはSnowpark用に最適化されたものから標準に変換することでトリガーされます。このイベントは、ウェアハウスの実行中に変換が発生した場合にのみ出力されます。

クラスター番号	変換されたクラスターの数（単一クラスターウェアハウスの場合は常に `1`）
イベントの状態	COMPLETED または STARTED
イベントの理由	CONVERT_TO_SNOWPARK_OPTIMIZED または CONVERT_TO_STANDARD

Tip

RESUME_CLUSTER

一時停止中のクラスターを再開するとトリガーされます。

クラスター番号	再開されたクラスターの番号(単一クラスターウェアハウスの場合は常に `1`)
イベントの状態	STARTED
イベントの理由	WAREHOUSE_AUTORESUME または WAREHOUSE_RESUME (単一クラスターウェアハウス) MULTICLUSTER_SPINUP (マルチクラスターウェアハウス)

コストへの影響: プロビジョニングが完了すると、クラスターのコンピューティングリソースで計測が開始されます。

SUSPEND_CLUSTER

実行中のクラスターが一時停止されたときにトリガーされます。

クラスター番号	中断されたクラスターの数(単一クラスターウェアハウスの場合は常に `1`)
イベントの状態	STARTED
イベントの理由:	WAREHOUSE_AUTOSUSPEND または WAREHOUSE_SUSPEND (単一クラスターウェアハウス) MULTICLUSTER_SPINDOWN (マルチクラスターウェアハウス) RESOURCE_MONITOR_SUSPEND

コストへの影響: 実行中のすべてのクエリが完了すると、クラスターのコンピューティングリソースでの計測が停止します。

RESIZE_CLUSTER

通常、ウェアハウスのサイズ変更の結果として、クラスターのサイズが変更されたときにトリガーされます。

クラスター番号	サイズ変更されたクラスターの数: (単一クラスターウェアハウスの場合は常に `1`)
イベントの状態	STARTED
イベントの理由	WAREHOUSE_AUTORESUME または WAREHOUSE_RESUME (単一クラスターウェアハウス) MULTICLUSTER_SPINDOWN または MULTICLUSTER_SPINUP (マルチクラスターウェアハウス) WAREHOUSE_RESIZE

SPINUP_CLUSTER

クラスターが開始されたときにトリガーされます(マルチクラスターウェアハウスのみ)。通常、最小/最大クラスターサイズが増加すると発生します。

クラスター番号	起動したクラスターの番号
イベントの状態	STARTED
イベントの理由	WAREHOUSE_RESIZE （単一クラスターウェアハウス） MULTICLUSTER_SPINUP (マルチクラスターウェアハウス)

コストへの影響: プロビジョニングが完了すると、クラスターのコンピューティングリソースで計測が開始されます。

SPINDOWN_CLUSTER

実行中のクラスターがシャットダウンしたときにトリガーされます(マルチクラスターウェアハウスのみ)。通常、最小/最大クラスターサイズが減少したときに発生します。

クラスター番号	シャットダウンしたクラスターの番号
イベントの状態	STARTED
イベントの理由	WAREHOUSE_RESIZE （単一クラスターウェアハウス） MULTICLUSTER_SPINDOWN (マルチクラスターウェアハウス)

コストへの影響: 実行中のすべてのクエリが完了すると、クラスターのコンピューティングリソースでの計測が停止します。

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

使用上の注意¶

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

イベントによって関連する追加イベントがトリガーされる場合、ビューに複数の行が生成される場合があります。
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 account_name, timestamp, warehouse_name, cluster_number,
       event_name, event_reason, event_state,
       size, cluster_count
  FROM SNOWFLAKE.ORGANIZATION_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