SQLウェアハウスを作成する
ワークスペース管理者と十分な特権を持つユーザーは、 SQLウェアハウスを構成および管理できます。 この記事では、既存の SQLウェアハウスを作成、編集、監視する方法の概要を説明します。
または、TerraformやSQLウェアハウスAPIを使用してSQLウェアハウスを作成することもできます。
Databricks では、利用可能な場合はサーバーレス SQLウェアハウスを使用することをお勧めします。
ほとんどのユーザーは SQLウェアハウスを作成できませんが、接続できる任意の SQLウェアハウスを再起動できます。 SQLウェアハウスへの接続を参照してください。
必要条件
SQLウェアハウスには、次の要件があります。
- SQLウェアハウスを作成するには、ワークスペース管理者であるか、または、無制限のクラスター作成権限を持つユーザーでなければなりません。
- 機能をサポートするリージョンでサーバーレスSQLウェアハウスを作成する前に、ステップが必要な場合があります。 「サーバレスSQLウェアハウスのセットアップ」を参照してください。
SQLウェアハウスを作成する
Web UIを使用してSQLウェアハウスを作成するには、以下の手順に従ってください。
- サイドバーの「 SQLウェアハウス 」をクリックします。
- [ SQLウェアハウスを作成 ] をクリックします。
- ウェアハウスの [ 名前 ] を入力します。
- (オプション)ウェアハウスの設定を構成します。 「SQLウェアハウス設定の構成」を参照してください。
- (オプション)詳細オプションを設定します。 詳細オプションを参照してください。
- 作成 をクリックします。
- (オプション) SQLウェアハウスへのアクセスを構成します。 SQLウェアハウスの管理を参照してください。
作成したウェアハウスが自動的に起動します。

SQLウェアハウスの設定を構成する
SQLウェアハウスの作成または編集中に、次の設定を変更できます。
-
クラスターサイズ は、クラスターに関連付けられたドライバーノードのサイズとワーカーノードの数を表します。デフォルトでは X-Large です。クエリーの待ち時間を減らすには、サイズを大きくしてください。
-
自動停止 は、指定した分数の間アイドル状態になった場合にウェアハウスが停止するかどうかを決定します。アイドル状態の SQLウェアハウスは、停止するまで DBU とクラウドインスタンスの料金を蓄積し続けます。
- ProおよびクラシックSQLウェアハウス :デフォルトでは45分です。これは、一般的な使用に推奨される分数です。最小の分数は10分です。
- サーバーレスSQLウェアハウス :デフォルトでは10分です。これは、一般的な使用に推奨される分数です。UIを使用する場合の最小値は5分です。SQLウェアハウスのAPIを使用してサーバーレスSQLウェアハウスを作成することもできる点にご注意ください。この場合、自動停止の値を1分にまで下げることができます。
-
スケーリング では、クエリーに使用されるクラスターの最小数と最大数を設定します。デフォルトでは、クラスターの最小数と最大数ともに1となっています。特定のクエリーに対してより多くのユーザーを並行処理する場合は、クラスターの最大数を増やします。Databricksでは、10個のクエリーの並行処理対して1つのクラスターを推奨します。
最適なパフォーマンスを維持するために、Databricks は 24 時間以上稼働しているクラスターをリサイクルします。リサイクル中、Databricks は新しいクラスターを立ち上げ、古いクラスターを廃止する一方で、新しいクエリーを新しいクラスターへ移行し始めます。既存のクエリーは、完了するまで古いクラスター上で実行され続けます。
この移行期間中、一時的にクラスター数が設定された最大値を超えることがあります。たとえば、最大クラスター数が1に設定されている場合、リサイクル中に2つのアクティブなクラスターが表示されることがあります。Databricksは、古いクラスター上のすべてのクエリが完了するまで終了を待機します。
既存のクエリーが24時間を超えて古いクラスターで実行され続ける場合、Databricksはリサイクルプロセスを完了するために、最終的にクラスターを強制終了する可能性があります。中断のリスクを軽減するために、長時間実行されるワークロードは24時間以内に完了するように設計するか、より小さなクエリーに分割してください。
- タイプ は、ウェアハウスのタイプを決定します。 サーバレスがアカウントで有効になっている場合、サーバレスがデフォルトです。 リストについては SQLウェアハウスのタイプ を参照してください。
詳細オプション
新しいSQL ウェアハウスを作成するとき、または既存の ウェアハウスを編集するときに[詳細オプション]SQL 領域を展開して、次の詳細オプションを構成します。これらのオプションは、SQLウェアハウス APIを使用して構成することもできます。
-
タグ : タグを使用すると、組織内のユーザーやグループが使用するクラウドリソースのコストを監視できます。 タグはキーと値のペアとして指定します。
-
Unity Catalog : ワークスペースでUnity Catalogが有効になっている場合、ワークスペース内のすべての新しいウェアハウスのデフォルトになります。ワークスペースで Unity Catalog が有効になっていない場合、このオプションは表示されません。 「Unity Catalog とは」を参照してください。
-
チャンネル : Preview チャンネルを使用して、クエリやダッシュボードなどの新機能を Databricks SQL 標準になる前にテストします。
リリースノートには、最新のプレビューバージョンの内容がリストされています。
Databricks では、本番運用ワークロードにプレビュー版を使用しないことをお勧めします。 ウェアハウスのプロパティ (チャンネルを含む) を表示できるのはワークスペース管理者のみであるため、 Databricks SQL ウェアハウスがそのウェアハウスの名前でプレビュー バージョンを使用していることを示すことを検討し、ユーザーが本番運用ワークロードに使用しないようにすることを検討してください。
Databricks also supports per-warehouse statement timeouts that you can set with the SQL warehouses API. This option is not available in the UI. For details, see Statement timeout.
ユーザーレベルのデフォルトウェアハウスを設定する
クエリの実行時に自動的に使用されるように、安心SQLウェアハウスを設定できます。 この設定は、ワークスペース レベルのデフォルトのウェアハウス (存在する場合) を上書きします。「ワークスペース用の安心SQLウェアハウスの設定」を参照してください。
ドロップダウン メニューを使用して、SQL エディター、AI/BI ダッシュボード、Genie、アラート、カタログ エクスプローラーなどの Databricks SQL 作成サーフェスから新しいデフォルトを設定します。
ユーザーレベルのデフォルトウェアハウスを設定するには:
-
ドロップダウンメニューをクリックして、[ SQLウェアハウス コンピュート]を選択します。
-
[ Customize your default ウェアハウス ]をクリックします。

-
次のいずれかを選択します。
- ワークスペース デフォルト: この設定のままにして、ワークスペースに設定されたデフォルトウェアハウスを使用します。
- 最終選択: デフォルト選択には、コンピュートとして選択した最後のウェアハウスが表示されます。
- カスタムデフォルト: 新しい SQLウェアハウスをデフォルトウェアハウスとして選択してください。 これにより、ワークスペースレベルのデフォルト設定が上書きされます。 設定後、選択したウェアハウスが自動的にコンピュートとして選択されます。 ドロップダウンメニューで別の SQLウェアハウスを選択することで、この設定を手動で上書きできます。
SQLウェアハウスの管理
ワークスペース管理者とCAN MANAGE SQLSQLウェアハウスに対する 権限を持つユーザーは、既存の ウェアハウスで次のタスクを完了できます。
-
実行中のウェアハウスを停止するには、ウェアハウスの横にある [停止] アイコンをクリックします。
-
停止したウェアハウスを開始するには、ウェアハウスの横にある [開始] アイコンをクリックします。
-
ウェアハウスを編集するには、ケバブメニューをクリックし
次に 編集 をクリックします。
-
権限を追加および編集するには、ケバブメニュー
をクリックし、次に [権限] をクリックします。
- Can view の割り当てによって、ユーザーがクエリ履歴やクエリ プロファイルなどの SQLウェアハウスを表示できるようにします。これらのユーザーは、ウェアハウスに対してクエリを実行できません。
- ウェアハウスでクエリを実行する必要があるユーザーに Can use 権限を割り当てます。
- クエリのパフォーマンスのトラブルシューティングと最適化のために、パワー ユーザーに Can monitor を割り当てます。 Can monitor 権限を使用すると、ユーザーはクエリを実行し、クエリ履歴やクエリ プロファイルなどの SQLウェアハウスを監視できます。
- SQLウェアハウスのサイジングと支出制限の決定を担当するユーザー Can manage を割り当てます。
- [所有者] は、 SQLウェアハウスの作成者に自動的に適用されます。
アクセス許可レベルの詳細については、「SQLウェアハウスのACL」を参照してください。
-
SQLウェアハウスをサーバレスにアップグレードするには、ケバブ メニュー
をクリックし、[ サーバレスにアップグレード ] をクリックします。
-
ウェアハウスを削除するには、ケバブメニュー
をクリックし、[ 削除 ]をクリックします。
Databricks の担当者に連絡して、14 日以内に削除されたウェアハウスを復元してください。