SQL ウェアハウスを作成する

ワークスペース管理者と十分な特権を持つユーザーは、SQL ウェアハウスを構成および管理できます。 この記事では、既存の SQL ウェアハウスを作成、編集、監視する方法の概要を示します。

SQL Warehouse API、または Terraform を使って、SQL ウェアハウスを作成することもできます。

Databricks では、使用可能な場合はサーバーレス SQL ウェアハウスを使用することをお勧めします。

注

ほとんどのユーザーは SQL ウェアハウスを作成できませんが、接続できる SQL ウェアハウスを再起動することはできます。 「SQL ウェアハウスに接続する」を参照してください。

要件

SQL ウェアハウスには、次の要件があります。

  • クラシックまたはプロ SQL ウェアハウスの場合、Azure アカウントには十分な vCPU クォータが必要です。 通常、既定の vCPU クォータはサーバーレス SQL ウェアハウスを作成するのに十分ですが、SQL ウェアハウスをスケーリングしたり、追加のウェアハウスを作成したりするには不十分な場合があります。 「クラシックおよびプロ SQL ウェアハウスに必要な Azure vCPU クォータ」を参照してください。 追加の vCPU クォータを要求できます。 Azure アカウントには、要求できる vCPU クォータの量に制限がある場合があります。 詳細については、Azure アカウント チームにお問い合わせください。

SQLウェアハウスを作成する

Web UI を使用して SQL Warehouse を作成するには、次のようにします。

  1. サイドバーの [SQL Warehouse] (SQL ウェアハウス) をクリックします。
  2. [ SQL ウェアハウスの作成] をクリックします。
  3. 倉庫名を入力してください。
  4. (省略可能) ウェアハウスの設定を構成します。 「SQL ウェアハウスの設定を構成する」を参照してください。
  5. (オプション) 詳細設定オプションを構成します。 「詳細オプション」を参照してください。
  6. Create をクリックしてください。
  7. (省略可能) SQL ウェアハウスへのアクセスを構成します。 「SQL ウェアハウスを管理する」を参照してください。

作成したウェアハウスが自動的に開始されます。

デフォルトのSQLウェアハウス構成

SQL ウェアハウス設定を構成する

SQL ウェアハウスの作成または編集時、次の設定を変更できます。

  • クラスタサイズ は、ドライバーノードのサイズとクラスタに関連付けられたワーカーノード数を表します。 既定値は X-Large です。 クエリの待機時間を短縮するには、サイズを増やします。

  • 自動停止は、指定された分数の間アイドル状態の場合に、倉庫を停止するかどうかを決定します。 アイドル状態の SQL ウェアハウスには、停止するまで DBU とクラウド インスタンス料金が蓄積し続けます。

    • Pro および classic SQL ウェアハウス:デフォルトは 45 分で、一般的な使用にはこれが推奨されます。 最小値は 10 分です。
    • サーバーレスSQLウェアハウス:デフォルトは10分で、一般的な使用には推奨されます。 UI を使用する場合の最小値は 5 分です。 SQL warehouses API を使用してサーバーレス SQL ウェアハウスを作成できます。この場合、[自動停止] の値を 1 分に設定できます。
  • スケーリング は、クエリで使用されるクラスタの最小数と最大数を設定します。 既定値は最小、最大 1 台のクラスターです。 特定のクエリに対してより多くの同時ユーザーを処理したい場合は、クラスターの最大数を増やすことができます。 Azure Databricks では、10 個の同時クエリごとに 1 台のクラスターが推奨されます。

    最適なパフォーマンスを維持するために、Azure Databricksは24時間以上稼働しているクラスターを再利用します。 リサイクル中、Azure Databricks は新しいクラスターを起動し、古いクラスターの使用停止中に新しいクエリの移行を開始します。 既存のクエリは終了するまで旧クラスタ上で実行され続けます。

    この移行期間中に、構成された最大値を超えるクラスター数が一時的に表示されることがあります。 たとえば、クラスターの最大数が 1 に設定されている場合、リサイクル中にアクティブなクラスターが 2 つ表示されることがあります。 Azure Databricks は、古いクラスターのすべてのクエリが終了するまで待機してから終了します。

    重要

    既存のクエリが24時間を超えて旧クラスタで実行され続ける場合、Azure Databricksは最終的にクラスターを強制的に終了させてリサイクルプロセスを完了させる可能性があります。 中断のリスクを減らすために、長時間実行されるワークロードを24時間以内に完了させる設計をするか、クエリを小さなものに分割しましょう。

  • タイプ は倉庫の種類を決定します。 アカウントでサーバーレスが有効になっている場合、サーバーレスが既定値になります。 一覧については、「SQL ウェアハウスの種類」を参照してください。

高度なオプション

新しい SQL ウェアハウスを作成するとき、または既存の SQL ウェアハウスを編集するときに、[詳細オプション] 領域を展開することで、次の詳細オプションを構成します。 これらのオプションは、SQL Warehouse API を使って構成することもできます。

  • タグ:タグを使うことで、組織内のユーザーやグループが使用するクラウドリソースのコストを監視できます。 タグはキーと値のペアとして指定します。

  • Unity Catalog: ワークスペースで Unity Catalog が有効になっている場合、ワークスペース内のすべての新しいウェアハウスのデフォルト設定になります。 ワークスペースに対して Unity Catalog が有効になっていない場合、このオプションは表示されません。 「Unity Catalog とは」を参照してください。

  • チャネル:Preview チャネルを使って、Databricks SQL 標準となる前にクエリやダッシュボードを含む新機能をテストしましょう。

    リリース ノートには、最新のプレビュー バージョンの内容が一覧表示されます。

重要

Databricks では、実稼働ワークロードにプレビュー バージョンを使用しないことを推奨しています。 ワークスペース管理者のみがチャネルを含むウェアハウスのプロパティを表示できるため、Databricks SQL ウェアハウスがそのウェアハウスの名前のプレビュー バージョンを使用して、ユーザーが運用環境のワークロードに使用できないようにすることを検討してください。

Azure Databricksでは、SQL Warehouses API で設定できるウェアハウスごとのステートメント タイムアウトもサポートされます。 このオプションは UI では利用できません。 詳細については、「 ステートメントのタイムアウト」を参照してください。

ユーザーレベルのデフォルトウェアハウスを設定する

クエリの実行時に自動的に使用する既定の SQL ウェアハウスを設定できます。 この設定は、ワークスペース レベルの既定のウェアハウス (存在する場合) をオーバーライドします。 ワークスペースの既定の SQL ウェアハウスの設定を参照してください。

ドロップダウン メニューを使用して、SQL エディター、AI/BI ダッシュボード、Genie、アラート、カタログ エクスプローラーなど、Databricks SQL オーサリング 画面から新しい既定値を設定します。

ユーザー レベルの既定のウェアハウスを設定するには:

  1. ドロップダウン メニューをクリックして、SQL Warehouse コンピューティングを選択します。

  2. [ 既定のウェアハウスのカスタマイズ] をクリックします。

    SQL ウェアハウスのドロップダウンメニューに、リストの一番下にデフォルトウェアハウスをカスタマイズするオプションが表示されます。

  3. 次のいずれかのオプションを選びます。

  • ワークスペースのデフォルト設定: この設定を保持して、ワークスペースのデフォルト倉庫セットを使用するため。
  • 最終選択: デフォルトの選択では、最後にコンピュート用に選択したウェアハウスが表示されます。
  • カスタムデフォルト: 新しいSQL倉庫をデフォルト倉庫として選択します。 これにより、ワークスペース レベルの既定の設定がオーバーライドされます。 設定後、選択した倉庫が計算リソースとして自動的に選ばれます。 この設定を手動でオーバーライドするには、ドロップダウン メニューで別の SQL ウェアハウスを選択します。

SQL ウェアハウスを管理する

ワークスペース管理者と SQL ウェアハウスに対する CAN MANAGE 特権を持つユーザーは、既存の SQL ウェアハウスで次のタスクを実行できます。

  • 実行中のウェアハウスを停止するには、ウェアハウスの横にある停止アイコンをクリックします。

  • 停止したウェアハウスを起動するには、ウェアハウスの横にある起動アイコンをクリックします。

  • 倉庫を編集するには、Kebab メニューの Kebab メニュー アイコン をクリックし、[ 編集] をクリックします。

  • アクセス許可を追加および編集するには、Kebab メニューの [ Kebab] メニュー アイコン をクリックし、[ アクセス許可] をクリックします。

    • 割り当て 可能ビュー を使用すると、ユーザーはクエリ履歴やクエリ プロファイルなどの SQL ウェアハウスを表示できます。 これらのユーザーは、ウェアハウスでクエリを実行できません。
    • ウェアハウスでクエリを実行する必要があるユーザーに使用可能を割り当てます。
    • パワーユーザーにCan monitorを割り当てて、クエリのパフォーマンスのトラブルシューティングと最適化を行うことができます。 Can monitor 権限により、ユーザーはクエリを実行し、クエリ履歴やクエリプロファイルを含む SQL ウェアハウスを監視できます。
    • SQL ウェアハウスのサイズ設定と支出制限の決定を担当するユーザーに管理可能を割り当てます。
    • 所有者 は自動的に SQL ウェアハウスの作成者に適用されます。

    アクセス許可レベルの詳細については、「SQL ウェアハウスの ACL」を参照してください。

  • SQL ウェアハウスをサーバーレスにアップグレードするには、Kebab メニューの Kebab メニュー アイコンをクリックし、[ サーバーレスにアップグレード] をクリックします。

  • 倉庫を削除するには、Kebab メニューの [Kebab] メニュー アイコンをクリックし、[ 削除] をクリックします。

注

削除されたウェアハウスを 14 日以内に復元するには、Databricks の担当者にお問い合わせください。