WAREHOUSE_EVENTS_HISTORY ビュー(ACCOUNT_USAGE): 新しい列とイベントへの変更

注意

この動作変更は2024_04バンドルにあります。

バンドルの現在のステータスについては、 バンドル履歴 をご参照ください。

この動作変更バンドルを有効にすると、Account Usage WAREHOUSE_EVENTS_HISTORY ビュー が以下のように変更されます。

新しい列

以下の列がビューに追加されます。

列名

データ型

説明

SIZE

VARCHAR

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

CLUSTER_COUNT

NUMBER

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

これらの列は、ビューの最後(一番右側)の列として追加されます。

新しいイベント: WAREHOUSE_CONSISTENT

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

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

EVENT_NAME

説明

WAREHOUSE_CONSISTENT

ウェアハウスへの保留中の変更が完了すると、この状態になります。

イベントへの変更

この動作変更バンドルが有効になると、イベント状態 PARTIALLY_COMPLETED は廃止されます。

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

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

たとえば、 ALTER ステートメントは、保留中の追加変更がない場合、 COMPLETED 状態でログ記録されます。

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

ALTER ステートメントでウェアハウスのサイズが変更されると、ウェアハウスのサイズ変更イベントが続きます。

ALTER WAREHOUSE my_wh SET
  WAREHOUSE_SIZE = 'SMALL';
Copy

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

TIMESTAMP

WAREHOUSE_NAME

EVENT_NAME

EVENT_STATE

SIZE

CLUSTER_COUNT

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

MY_WH

ALTER_WAREHOUSE

STARTED

NULL

NULL

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

MY_WH

RESIZE_WAREHOUSE

STARTED

NULL

NULL

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

MY_WH

WAREHOUSE_CONSISTENT

COMPLETED

SMALL

1

WAREHOUSE_CONSISTENT イベントは、別のウェアハウスイベントと同じタイムスタンプを共有し、順番がずれて表示される可能性があることに注意してください。

ウェアハウスイベントの EVENT_STATE 列の可能な値は以下のように変更されます。

EVENT_NAME

変更前の EVENT_STATE

変更後の EVENT_STATE

CREATE_WAREHOUSE

COMPLETED

それ以上の変更が保留されていない場合は COMPLETED、それ以外の場合は STARTED。

ほとんどの場合、 RESUME_WAREHOUSE イベントが続きます。

DROP_WAREHOUSE

COMPLETED

それ以上の変更が保留されていない場合は COMPLETED、それ以外の場合は STARTED。

ほとんどの場合、 SUSPEND_WAREHOUSE イベントが続きます。

ALTER_WAREHOUSE

COMPLETED

それ以上の変更が保留されていない場合は COMPLETED、それ以外の場合は STARTED(ALTER ステートメントにより、 最終的に一貫性のあるイベントが続く場合。)

RESIZE_WAREHOUSE

STARTED、 . COMPLETED、 . PARTIALLY_COMPLETED

STARTED

RESUME_WAREHOUSE

STARTED、 . COMPLETED、 . PARTIALLY_COMPLETED

STARTED

SUSPEND_WAREHOUSE

STARTED、 . COMPLETED、 . PARTIALLY_COMPLETED

STARTED

RESUME_CLUSTER

COMPLETED

STARTED

SUSPEND_CLUSTER

COMPLETED

STARTED

RESIZE_CLUSTER

COMPLETED

STARTED

SPINUP_CLUSTER

STARTED、 . COMPLETED、 . PARTIALLY_COMPLETED

STARTED

SPINDOWN_CLUSTER

STARTED、 . COMPLETED、 . PARTIALLY_COMPLETED

STARTED

参照: 1616