CREATE INTERACTIVE WAREHOUSE¶

インタラクティブなテーブルを使用する、低レイテンシで同時実行性の高いワークロード向けに最適化された、新しいインタラクティブな仮想ウェアハウスを作成します。

インタラクティブウェアハウスは、インタラクティブテーブルを操作するときに最適なクエリパフォーマンスを提供するように設計されています。インテリジェントなキャッシュと最適化によって、頻繁にアクセスされるデータに対する高速なクエリ応答を提供します。

こちらもご参照ください。: CREATE WAREHOUSE, ALTER WAREHOUSE, DESCRIBE WAREHOUSE, DROP WAREHOUSE, SHOW WAREHOUSES, CREATE INTERACTIVE TABLE

構文¶

CREATE [ OR REPLACE ] INTERACTIVE WAREHOUSE [ IF NOT EXISTS ] <name>
       [ TABLES ( <table_name> [ , <table_name> ... ] ) ]
       [ [ WITH ] objectProperties ]
       [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
       [ objectParams ]

条件:

objectProperties ::=
  WAREHOUSE_SIZE = { XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE | X5LARGE | X6LARGE }
  MAX_CLUSTER_COUNT = <num>
  MIN_CLUSTER_COUNT = <num>
  AUTO_SUSPEND = { <num> | NULL }
  AUTO_RESUME = { TRUE | FALSE }
  INITIALLY_SUSPENDED = { TRUE | FALSE }
  RESOURCE_MONITOR = <monitor_name>
  COMMENT = '<string_literal>'

objectParams ::=
  MAX_CONCURRENCY_LEVEL = <num>
  STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
  STATEMENT_TIMEOUT_IN_SECONDS = <num>

パラメーター¶

name

インタラクティブウェアハウスの識別子を指定します。識別子は、アカウント内で一意である必要があります。

詳細については、識別子の要件をご参照ください。

TABLES ( ... )

オプションで、インタラクティブウェアハウスにすぐに関連付けるための、インタラクティブテーブル名のコンマ区切りリストを指定します。この句を使用すると、ウェアハウスの作成時に指定されたテーブルのキャッシュ準備プロセスが開始されます。

table_name

ウェアハウスに関連付けるインタラクティブテーブルの識別子を指定します。コンマで区切られた複数のテーブル名を指定できます。

注釈

指定されたすべてのテーブルは、 INTERACTIVE キーワード付きで作成されたインタラクティブなテーブルである必要があります。
この句を省略すると、後で ADD TABLES 句で ALTER WAREHOUSE を使用してインタラクティブテーブルを関連付けることができます。
データのサイズによっては、キャッシュの準備に非常に多くの時間が必要になる場合があります。

WAREHOUSE_SIZE = string_constant

インタラクティブウェアハウスのサイズを指定します。インタラクティブウェアハウスは、インタラクティブなワークロード向けに最適化された特定のサイズをサポートします。

有効な値:

XSMALL、 'X-SMALL'
SMALL
MEDIUM
LARGE
XLARGE、 'X-LARGE'
XXLARGE、 X2LARGE、 '2X-LARGE'
XXXLARGE、 X3LARGE、 '3X-LARGE'

デフォルト:

XSMALL

注釈

ハイフンを含む値（例えば、 '2X-LARGE'）を使用するには、示されているように値を一重引用符で囲む必要があります。
ワークロードの要件に合わせてウェアハウスのサイズを選択します。MIN_CLUSTER_COUNT および MAX_CLUSTER_COUNT プロパティを調整して同時実行向けに最適化できます。

MAX_CLUSTER_COUNT = num

マルチクラスターのインタラクティブウェアハウスに対するクラスターの最大数を指定します。

有効な値:: 1 から 10 （ウェアハウスのサイズによる）
デフォルト:: 1 （単一クラスターウェアハウス）

MIN_CLUSTER_COUNT = num

マルチクラスターのインタラクティブウェアハウスに対するクラスターの最小数を指定します。

有効な値:: 1 から MAX_CLUSTER_COUNT の値
デフォルト:: 1

AUTO_SUSPEND = { num | NULL }

インタラクティブウェアハウスが自動的に中断されるまでの非アクティブの秒数を指定します。

インタラクティブウェアハウスの最小値は``86400``（24時間）です。86400より小さい値を指定すると、Snowflakeは86400を使用します。値を``NULL``に設定すると、自動一時停止が無効になります。

デフォルト:: ``NULL``（自動一時停止は無効）

AUTO_RESUME = { TRUE | FALSE }

SQLステートメントが送信されたときに、インタラクティブウェアハウスを自動的に再開するかどうかを指定します。

デフォルト:: FALSE

INITIALLY_SUSPENDED = { TRUE | FALSE }

インタラクティブウェアハウスを一時停止状態で作成するかどうかを指定します。

デフォルト:: ``TRUE``（インタラクティブウェアハウスが一時停止状態で作成される）

RESOURCE_MONITOR = monitor_name

クレジット使用状況の制御のためにインタラクティブウェアハウスに割り当てる、リソースモニターの識別子を指定します。

有効な値:: 既存のリソースモニター
デフォルト:: 値なし（リソースモニターの割り当てなし）

COMMENT = 'string_literal'

インタラクティブウェアハウスのコメントを指定します。

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

タグの名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、タグの割り当てをご参照ください。

MAX_CONCURRENCY_LEVEL = num: インタラクティブウェアハウスクラスターによって実行される SQL ステートメントの同時実行レベルを指定します。
STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = num: SQL ステートメントがキャンセルされる前にキューに入れることができる時間を秒単位で指定します。
STATEMENT_TIMEOUT_IN_SECONDS = num: 実行中の SQL ステートメントがキャンセルされるまでの時間を秒単位で指定します。インタラクティブウェアハウスの最大タイムアウト間隔は5秒です。これより大きな値は無視されます。

アクセス制御の要件¶

この SQL コマンドの実行に使用されるロールには、最低 1 つの次の権限が必要です。


権限	オブジェクト	メモ
CREATE WAREHOUSE	アカウント	インタラクティブウェアハウスを含む、ウェアハウスを作成するために必要です。
USAGE	インタラクティブテーブル	`TABLES` 句で指定された各インタラクティブテーブルについて必要です（使用する場合）。

指定された権限のセットを使用してカスタムロールを作成する手順については、カスタムロールの作成をご参照ください。

セキュリティ保護可能なオブジェクトに対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、アクセス制御の概要をご参照ください。

使用上の注意¶

OR REPLACE 句と IF NOT EXISTS 句は互いに排他的です。この2つを同じステートメントで使うことはできません。
CREATE OR REPLACE <オブジェクト> ステートメントはアトミックです。つまり、オブジェクトが置き換えられると、単一のトランザクションで、古いオブジェクトが削除されて新しいオブジェクトが作成されます。

インタラクティブウェアハウスは、デフォルトで SUSPENDED 状態で作成されます。ALTER WAREHOUSE を RESUME 句で使用してウェアハウスを開始します。
TABLES 句を指定すると、指定されたインタラクティブテーブルのキャッシュの準備がすぐに開始されます。このプロセスは、データサイズによっては、かなりの時間がかかる場合があります。
インタラクティブウェアハウスはインタラクティブテーブルのみをクエリできます。標準テーブルをクエリするには、CREATE WAREHOUSE で作成された標準ウェアハウスを使用します。
インタラクティブウェアハウスは、自動一時停止と自動再開をサポートしています。AUTO_SUSPENDの最小値は86400秒（24時間）です。詳細については、インタラクティブウェアハウスの再開と一時停止をご参照ください。
インタラクティブウェアハウスは、同時実効性の高いワークロードを処理するためのマルチクラスター構成をサポートしています。
作成中に TABLES 句を指定しない場合、後で ALTER WAREHOUSE を ADD TABLES 句で使用して、インタラクティブテーブルを関連付けることができます。
メタデータについて:

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールドをご参照ください。

請求と価格設定¶

インタラクティブウェアハウスの請求と価格設定の考慮事項については、コストと請求の考慮事項をご参照ください。

例¶

特定のインタラクティブテーブルに関連付けられたインタラクティブウェアハウスを作成します。

CREATE OR REPLACE INTERACTIVE WAREHOUSE sales_interactive_wh
  TABLES (orders, customers, products)
  WAREHOUSE_SIZE = 'MEDIUM'
  COMMENT = 'Interactive warehouse for sales team analytics';

関連するテーブルなし（後で追加）でインタラクティブウェアハウスを作成します。

CREATE INTERACTIVE WAREHOUSE analytics_interactive_wh
  WAREHOUSE_SIZE = 'LARGE'
  MAX_CLUSTER_COUNT = 3
  MIN_CLUSTER_COUNT = 3;

インタラクティブウェアハウスをリソースモニター付きで作成します。

CREATE INTERACTIVE WAREHOUSE dev_interactive_wh
  WAREHOUSE_SIZE = 'XSMALL'
  RESOURCE_MONITOR = dev_resource_monitor
  COMMENT = 'Development interactive warehouse';

インタラクティブウェアハウスを再開し、テーブルを関連付けます。

-- Resume the warehouse
ALTER WAREHOUSE sales_interactive_wh RESUME;

-- Add additional tables if needed
ALTER WAREHOUSE sales_interactive_wh ADD TABLES (inventory);