メインコンテンツまでスキップ

SQLウェアハウスリソースをDatabricksアプリに追加する

SQLウェアハウス を Databricks Apps リソースとして追加して、アプリがコンピュート リソースに接続し、クエリSQL実行できるようにします。

ウェアハウス リソース SQLを追加する​

SQLウェアハウスをリソースとして追加する前に、アプリのリソースの前提条件を確認してください。

  1. アプリ作成時の「 アプリリソース 」セクション、またはアプリ編集時の「 設定 」>「 リソース 」で、「 + リソースの追加 」>「 SQLウェアハウス 」をクリックします。

  2. ワークスペースで利用可能なオプションから SQLウェアハウスを選択します。

  3. アプリに適した権限レベルを選択します。

    • 使用できる: SQLウェアハウスに接続し、クエリを実行するためのアクセス許可をアプリに付与します。これは、ほとんどのアプリケーションに必要な最小限の権限です。
    • 管理 できるもの: 構成、スケーリング、その他の管理設定を変更するアクセス許可をアプリに付与します。これは、アプリがウェアハウスを管理する必要がある場合にのみ選択します。
  4. (オプション)カスタム リソース アプリ構成で SQLウェアハウスを参照する方法です。 デフォルトのキーは sql-warehouseです。

環境変数​

SQL warehouseリソースを使用してアプリをデプロイする場合、valueFrom フィールドを使用してリソースを参照する環境変数を app.yaml で定義することにより、warehouse IDをアプリに公開します。変数名は自分で決めます。

詳細については、 リソースから環境変数にアクセスするを参照してください。

SQLウェアハウス リソースを削除する​

アプリから SQLウェアハウスリソースを削除すると、アプリのサービスプリンシパルはウェアハウスにアクセスできなくなります。 SQLウェアハウス自体は変更されず、適切な権限を持つ他のユーザーやアプリケーションが引き続き使用できます。

ベストプラクティス​

SQLウェアハウス リソースを扱うときは、次の点を考慮してください。

  • 最小限の権限を付与します。アプリがウェアハウスで管理タスクを実行する必要がある場合を除き、 Can use アクセス許可を使用します。
  • SQLウェアハウスはコンピュートリソースを消費します。 アプリのクエリ パターンとウェアハウスの使用率を監視して、コストを最適化します。
  • アプリに再試行ロジックとエラー処理を実装して、潜在的な接続の問題やウェアハウスの利用不能を管理します。
  • アプリのパフォーマンス要件と予想されるクエリの負荷に一致するウェアハウス サイズを選択します。