CREATE WAREHOUSE¶

構文¶

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

条件:

objectProperties ::=
  WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' }
  WAREHOUSE_SIZE = { XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE | X5LARGE | X6LARGE }
  RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 }
  MAX_CLUSTER_COUNT = <num>
  MIN_CLUSTER_COUNT = <num>
  SCALING_POLICY = { STANDARD | ECONOMY }
  AUTO_SUSPEND = { <num> | NULL }
  AUTO_RESUME = { TRUE | FALSE }
  INITIALLY_SUSPENDED = { TRUE | FALSE }
  RESOURCE_MONITOR = <monitor_name>
  COMMENT = '<string_literal>'
  ENABLE_QUERY_ACCELERATION = { TRUE | FALSE }
  QUERY_ACCELERATION_MAX_SCALE_FACTOR = <num>

Copy

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

Copy

バリアント構文¶

CREATE OR ALTER WAREHOUSE <name>
     [ [ WITH ] objectProperties ]
     [ objectParams ]

objectProperties ::=
  WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' }
  WAREHOUSE_SIZE = { XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE | X5LARGE | X6LARGE }
  RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 }
  MAX_CLUSTER_COUNT = <num>
  MIN_CLUSTER_COUNT = <num>
  SCALING_POLICY = { STANDARD | ECONOMY }
  AUTO_SUSPEND = { <num> | NULL }
  AUTO_RESUME = { TRUE | FALSE }
  INITIALLY_SUSPENDED = { TRUE | FALSE }
  RESOURCE_MONITOR = <monitor_name>
  COMMENT = '<string_literal>'
  ENABLE_QUERY_ACCELERATION = { TRUE | FALSE }
  QUERY_ACCELERATION_MAX_SCALE_FACTOR = <num>

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

必須パラメーター¶

name

仮想ウェアハウスの識別子。アカウントに対して一意である必要があります。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

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

オプションのプロパティ（objectProperties）¶

WAREHOUSE_TYPE = { STANDARD | 'SNOWPARK-OPTIMIZED' }

ウェアハウスのタイプを指定します。

有効な値:

• STANDARD、 'STANDARD'

• 'SNOWPARK-OPTIMIZED'

デフォルト:

STANDARD

注釈

ハイフンを含む値（'SNOWPARK-OPTIMIZED'）を使用するには、示されているように値を一重引用符で囲む必要があります。

WAREHOUSE_SIZE = { XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE | X5LARGE | X6LARGE }

仮想ウェアハウスのサイズを指定します。サイズは、ウェアハウス内にある各クラスターのコンピューティングリソースの量を決定するため、ウェアハウスの稼働中に消費されるクレジットの数を決定します。

有効な値:

サポートされている 値	同義語
XSMALL	'X-SMALL'
SMALL
MEDIUM
LARGE
XLARGE	'X-LARGE'
XXLARGE	X2LARGE 、 '2X-LARGE'
XXXLARGE	X3LARGE 、 '3X-LARGE'
X4LARGE	'4X-LARGE'
X5LARGE	'5X-LARGE'
X6LARGE	'6X-LARGE'

デフォルト:

XSMALL

注釈

• Snowpark用に最適化されたウェアハウスの X5LARGE と X6LARGE サイズは、 MEMORY_16Xリソース制約でのみサポートされています。

• STANDARD_GEN_2リソース制約を使用する標準ウェアハウスでは、 X5LARGE と X6LARGE サイズはサポートされていません。

• Snowparkに最適化されたウェアハウスのデフォルトサイズは MEDIUM です。

• ハイフンを含む値（例えば、 '2X-LARGE'）を使用するには、示されているように値を一重引用符で囲む必要があります。

• 大規模なウェアハウスサイズ5X-Largeおよび6X-Largeは、すべてのAmazon Web Services（AWS）およびMicrosoft Azureリージョンで一般公開されています。

  大規模なウェアハウスサイズは、 US 政府リージョンでプレビュー中です（ARM での FIPS サポートが必要です）。

RESOURCE_CONSTRAINT = { STANDARD_GEN_1 | STANDARD_GEN_2 | MEMORY_1X | MEMORY_1X_x86 | MEMORY_16X | MEMORY_16X_x86 | MEMORY_64X | MEMORY_64X_x86 }

プレビュー機能 --- オープン

1 TB のリソース制約（MEMORY_64Xと MEMORY_64X_x86）はプレビュー機能として利用可能です。1 TB 制約は、Amazon Web Services（AWS）クラウドプラットフォームでのみ利用可能です。

その他のすべての MEMORY_* リソース制約サイズは一般公開されており、すべてのクラウドプラットフォームで利用可能です。

Snowpark用に最適化されたウェアハウス のメモリと CPU アーキテクチャ、または 標準ウェアハウスの第2世代機能 または第1世代機能を指定します。

以下の表には、プロパティの有効な値、使用可能なメモリ、 CPU アーキテクチャ、 resource_constraint 設定に必要な最小ウェアハウスサイズが含まれています。第2世代標準ウェアハウスが利用可能なリージョンとクラウドサービスプロバイダーの詳細については、 Snowflake第2世代標準ウェアハウス をご参照ください。

有効な値:

値	メモリ（最大）	CPU アーキテクチャ	必要最小ウェアハウスサイズ	最大ウェアハウスサイズ
STANDARD_GEN_1	16 GB	標準	XSMALL	X6LARGE
STANDARD_GEN_2	16 GB	標準（第2世代）	XSMALL	X4LARGE
MEMORY_1X	16 GB	標準	XSMALL	X4LARGE
MEMORY_1X_x86	16 GB	x86	XSMALL	X4LARGE
MEMORY_16X	256 GB	標準	MEDIUM	X6LARGE
MEMORY_16X_x86	256 GB	x86	MEDIUM	X4LARGE
MEMORY_64X	1 TB	標準	LARGE	X4LARGE
MEMORY_64X_x86	1 TB	x86	LARGE	X4LARGE

デフォルト値:

Snowpark用に最適化されたウェアハウス向けの:code:MEMORY_16X。標準ウェアハウスの場合、デフォルトは、クラウドサービスプロバイダー地域のGen2サポートと、その地域でGen2サポートが利用可能になった後に組織が作成されたかどうかによって異なります。詳細については、 標準ウェアハウスの RESOURCE_CONSTRAINT のデフォルト値 をご参照ください。

MAX_CLUSTER_COUNT = num

マルチクラスターウェアハウスに対するクラスターの最大数を指定します。単一クラスターのウェアハウスの場合、この値は常に 1 です。

有効な値:

1 を、ウェアハウスのサイズによって異なる上限値に設定します。

1 より大きい値を指定すると、ウェアハウスがマルチクラスターウェアハウスであることを示します。ただし、値は Snowflake Enterprise Edition （またはそれ以上）のみで、より高い値に設定できます。

各ウェアハウスサイズの上限値など、詳細については マルチクラスターウェアハウス をご参照ください。

デフォルト:

1 （単一クラスターウェアハウス）

Tip

Snowflake Enterprise Edition（またはそれ以上）の場合、マルチクラスターウェアハウスの高可用性と最適なパフォーマンスを維持するために、常に 1 より大きい値を設定することをお勧めします。また、これにより、万一クラスターに障害が発生した場合の継続性を確保できます。

MIN_CLUSTER_COUNT = num

マルチクラスターウェアハウスに対するクラスターの最小数を指定します（マルチクラスターウェアハウスにのみ適用）。

有効な値:

1 を MAX_CLUSTER_COUNT の値に設定します。MAX_CLUSTER_COUNT の上限はウェアハウスのサイズによって異なります。

MIN_CLUSTER_COUNT は MAX_CLUSTER_COUNT 以下である必要があります。

• 両方のパラメーターが等しい場合、ウェアハウスは 最大化 モードで実行されます。

• MIN_CLUSTER_COUNT が MAX_CLUSTER_COUNT 未満の場合、ウェアハウスは 自動スケール モードで実行されます。

各ウェアハウスサイズの上限値など、詳細については マルチクラスターウェアハウス をご参照ください。

デフォルト:

1

SCALING_POLICY = { STANDARD | ECONOMY }

自動スケールモードで実行されているマルチクラスターウェアハウスでクラスターを自動的に開始、およびシャットダウンするためのポリシーを指定します。

有効な値:

• STANDARD ：クラスターを開始することにより、キューイングを最小限にします。

• ECONOMY ：実行中のクラスターを完全にロードしたままにしておくことにより、クレジットを節約します。

詳細については、 マルチクラスターウェアハウスのスケーリングポリシーの設定 をご参照ください。

デフォルト:

STANDARD

AUTO_SUSPEND = { num | NULL }

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

有効な値:

任意の整数 0 以上、または NULL:

• ウェアハウスを一時停止するバックグラウンド処理は約30秒ごとに実行されるため、このプロパティの設定はウェアハウスの一時停止を正確に制御するためのものではありません。

• 30未満の値、または30の倍数でない値を設定することは可能ですが、ウェアハウスの一時停止のポーリング間隔が30秒であるため、期待した動作にならない可能性があります。

• 0 または NULL 値を設定すると、ウェアハウスが一時停止されることはなくなります。

デフォルト:

600 （ウェアハウスは、10分の非アクティブ後に自動的に一時停止します）

重要

クエリのワークロードが継続的に実行されるウェアハウスを必要としない限り、 AUTO_SUSPEND の値を 0 または NULL に設定することは推奨 しません。これにより、特に大規模なウェアハウスでは、クレジット（および対応する料金）が大幅に消費されることに注意してください。

AUTO_RESUME = { TRUE | FALSE }

SQL ステートメント（クエリなど）の送信時にウェアハウスを自動的に再開するかどうかを指定します。

有効な値:

• TRUE ：新しいクエリが送信されると、ウェアハウスが再開します。

• FALSE ：ウェアハウスは、 ALTER WAREHOUSE またはSnowflakeウェブインターフェイスを使用して明示的に再開された場合にのみ再開します。

デフォルト:

TRUE （ウェアハウスは SQL ステートメントが送信されると自動的に再開します）

INITIALLY_SUSPENDED = { TRUE | FALSE }

ウェアハウスが最初に「一時停止」状態で作成されるかどうかを指定します。

有効な値:

• TRUE ：ウェアハウスは作成されますが、中断されます。

• FALSE ：ウェアハウスは、作成後に実行を開始します。

デフォルト:

FALSE

RESOURCE_MONITOR = monitor_name

ウェアハウスに明示的に割り当てられているリソースモニターの名前を指定します。リソースモニターがウェアハウスに明示的に割り当てられている場合、モニターはウェアハウス（およびモニターが割り当てられている他のすべてのウェアハウス）が使用する月間クレジットを制御します。

有効な値:

既存のリソースモニター。

詳細については、 リソースモニターの操作 をご参照ください。

デフォルト:

値なし（ウェアハウスにリソースモニターが割り当てられていない）

Tip

すべてのリソースモニターとその識別子を表示するには、 SHOW RESOURCE MONITORS コマンドを使用します。

COMMENT = 'string_literal'

ウェアハウスのコメントを指定します。

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

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

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

ステートメントでのタグの指定に関する情報については、 オブジェクトのタグクォータ をご参照ください。

オプションのパラメーター（objectParams）¶

MAX_CONCURRENCY_LEVEL = num

ウェアハウスクラスターによって実行されるSQLステートメント（つまり、クエリおよびDML）の同時実行レベルを指定するオブジェクトパラメーター。

このパラメーターの詳細については、 MAX_CONCURRENCY_LEVEL をご参照ください。

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = num

SQLステートメント（クエリ、DDL、DMLなど）がシステムによりキャンセルされる前に、ウェアハウスのキューに入れることができる時間を秒単位で指定するオブジェクトパラメーター。

このパラメーターの詳細については、 STATEMENT_QUEUED_TIMEOUT_IN_SECONDS をご参照ください。

STATEMENT_TIMEOUT_IN_SECONDS = num

実行中のSQLステートメント（クエリ、DDL、DMLなど）がシステムによってキャンセルされるまでの時間を秒単位で指定するオブジェクトパラメーター。

このパラメーターの詳細については、 STATEMENT_TIMEOUT_IN_SECONDS をご参照ください。

アクセス制御の要件¶

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

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

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

一般的な使用上の注意¶

• 仮想ウェアハウスを作成すると、現在のセッション用に使用中のウェアハウスとして自動的に設定されます（ウェアハウスで USE WAREHOUSE コマンドを使用するのと同等）。

  現在のセッションで使用されているウェアハウスを変更するには、 CREATE WAREHOUSE ステートメントの後に明示的に USE WAREHOUSE ステートメントを実行します。たとえば、ウェアハウス my_wh を作成しますが、追加のステートメントを実行する際には my_wh ではなく、現在のウェアハウスを使用し続けます。

  SET current_wh_name = (SELECT CURRENT_WAREHOUSE());
  
  CREATE OR REPLACE WAREHOUSE my_wh
    WAREHOUSE_SIZE = 'XSMALL';
  
  USE WAREHOUSE IDENTIFIER($current_wh_name);
  

  Copy

• メタデータについて。

  注意

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

• OR REPLACE の使用は、既存のウェアハウスで DROP WAREHOUSE を使用してから、同じ名前で新しいウェアハウスを作成することと同じです。

  CREATE OR REPLACE <オブジェクト> ステートメントはアトミックです。つまり、オブジェクトが置き換えられると、単一のトランザクションで、古いオブジェクトが削除されて新しいオブジェクトが作成されます。

  ドロップしたウェアハウスで実行されているすべてのクエリは中止されます。

• OR REPLACE と IF NOT EXISTS 句は互いに排他的です。両方を同じステートメントで使うことはできません。

• Snowpark用に最適化された仮想ウェアハウスの初期作成と再開には、標準のウェアハウスよりも時間がかかる場合があります。

CREATE OR ALTER WAREHOUSE の使用上の注意¶

制限事項

• ALTER WAREHOUSE コマンドのすべての制限が適用されます。

• INITIALLY_SUSPENDED プロパティは変更できません（SET または UNSET）。

ウェアハウスのパラメーターとプロパティ

• 変更されたウェアハウス定義で以前に設定されていたプロパティやパラメーターがない場合は、そのプロパティやパラメーターの設定が解除されます。

• 明示的なパラメーター値の設定を解除すると、デフォルトのパラメーター値に設定されます。

データガバナンス

• CREATE OR ALTER WAREHOUSE ステートメントを使用したウェアハウスに対する、タグやポリシーの設定や設定解除はサポートされて いません。

• 既存のポリシーやタグは、CREATE OR ALTER WAREHOUSE ステートメントによって変更できず、そのまま残ります。

請求と価格設定¶

Snowparkに最適化されたウェアハウスのクレジット消費については、Snowflakeサービス利用表 の Table 1 を参照してください。

例¶

CREATE WAREHOUSE so_warehouse WITH
  WAREHOUSE_TYPE = 'SNOWPARK-OPTIMIZED'
  WAREHOUSE_SIZE = xlarge
  RESOURCE_CONSTRAINT = 'MEMORY_16X_x86';

CREATE OR ALTER WAREHOUSE so_warehouse
  WAREHOUSE_TYPE = 'SNOWPARK_OPTIMIZED'
  WAREHOUSE_SIZE = 'X-LARGE'
  RESOURCE_CONSTRAINT = 'MEMORY_16X_X86'
  AUTO_RESUME = TRUE
  COMMENT = 'Snowpark warehouse for ingestion';

CREATE OR ALTER WAREHOUSE so_warehouse
  WAREHOUSE_TYPE = 'SNOWPARK-OPTIMIZED'
  WAREHOUSE_SIZE = 'X-LARGE'
  RESOURCE_CONSTRAINT = 'MEMORY_16X_X86'
  AUTO_RESUME = FALSE
  COMMENT = 'Snowpark warehouse for ingestion (disabled for auto-resume)';