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

Databricks アプリの開発

備考

プレビュー

Databricks Apps は パブリック プレビュー段階です。

注記

Databricks ワークスペースでアプリをデプロイして実行するには、ファイアウォールがドメイン *.databricksapps.comをブロックしていないことを確認する必要があります。

AIDatabricksこの記事では、UI でアプリを作成および編集する方法、Databricks SQLウェアハウス、シークレット、 ジョブなどの プラットフォーム機能の使用方法、アプリ開発のベストDatabricks プラクティス、サポートされているフレームワークを使用してアプリを開発するための重要な情報など、 Apps を使用してデータ アプリと アプリを作成する方法について詳しく説明します。

Databricks Apps UI でアプリを作成するにはどうすればよいですか?

  1. サイドバーで「新しいアイコン 新規 」をクリックし、メニューから「 アプリ 」を選択します。

  2. 完全な事前構築済みのサンプル アプリから始めることも、ソース コードとアーティファクトを使用することもできます。

    • サンプル アプリから開始するには、[ テンプレート] を選択し、優先するフレームワークのタブをクリックして、アプリの一覧から選択します。
    • コードを使用してアプリを作成するには、[ カスタム ] を選択します。

    ページを表示して新しい Databricks アプリを作成する

  3. 次へ 」をクリックします。

  4. アプリ名フィールドに 、アプリの名前を入力し、オプションで説明を入力します。

注記
  • Databricks アプリに割り当てられた名前は、アプリの作成後に変更することはできず、Databricks ワークスペースにアクセスできるすべてのユーザーは、ワークスペース内のすべての Databricks アプリの名前とデプロイ履歴を確認できます。 さらに、アプリ名はシステムテーブルに書き込まれるレコードに含まれます。 この可視性のため、Databricks アプリに名前を付けるときに機密情報を含めないでください。

  • 名前は、アプリをホストする Databricks ワークスペース内で一意である必要があり、小文字、数字、ハイフンのみを含める必要があります。

Databricks アプリに名前を付けるページを表示する

[カスタム ] を選択した場合は、[ アプリを作成 ] をクリックします。 [テンプレート] を選択した場合は、必要なリソースを構成し、[ アプリの作成とデプロイ ] をクリックします。「 Databricks プラットフォーム機能を Databricks アプリに割り当てる」を参照してください。

ページを表示して Databricks アプリに名前を付け、リソースを追加する

アプリの詳細ページは、[ アプリの作成とデプロイ ] または [ アプリの作成 ] をクリックすると表示されます。 [テンプレート] を選択した場合、Databricks Apps はアプリを作成し、テンプレートのサンプル コードとアプリの必要な構成を含むアプリをデプロイします。アプリの詳細ページには、次の情報が表示されます。

  • アプリの作成と展開のステータス。
  • アプリのアーティファクトをローカル環境にコピーしたり、ローカルの変更を Databricks ワークスペースに同期したりするなど、アプリをローカルで開発を続行するために使用できる手順。

テンプレート化された Databricks アプリの詳細を表示する

[カスタム ] を選択した場合は、Databricks Apps によってアプリが作成されます。アプリのコードとアーティファクトを追加する必要があるため、アプリを別のステップとしてデプロイする必要があります。 アプリの詳細ページには、次の情報が表示されます。

  • アプリの作成ステータス。
  • アプリのコードとアーティファクトをローカル開発環境から Databricks ワークスペースに同期し、アプリをデプロイするために使用できる手順。

テンプレート化された Databricks アプリの詳細を表示する

ローカル開発環境を設定する方法、アプリのコードと構成をローカルで作成または更新する方法、アプリを Databricks ワークスペースに同期してデプロイする方法については、「 Databricks アプリの概要」を参照してください。 5. [テンプレート ] を選択し、アプリのアーティファクトをワークスペースからローカル開発環境にコピーする場合は、次のDatabricks CLIを使用できます。

Bash
databricks workspace export-dir <workspace-path> <target-path>

以下のように置き換えてください。

  • <workspace-path> は、アプリのコードとアーティファクトを含むワークスペースファイルディレクトリへのパスに置き換えます。
  • <target-path> を、ファイルのコピー先となるローカル環境内のパスに置き換えます。

Databricks プラットフォーム機能を Databricks アプリに割り当てる

注記

Databricks SQLを使用するには、サービスプリンシパルはSQLウェアハウスとクエリによってアクセスされるテーブルへのアクセスが必要です。

DatabricksDatabricks SQL、Databricks Jobs、Mosaic AI Model Serving 、Databricks シークレットなどの プラットフォームの機能を使用するには、これらの機能をリソースとしてアプリに追加します。リソースは、アプリ を作成 または編集するときに追加できます。

  1. [新しいアプリの作成 ] または [アプリの編集 ] カードで、[ 詳細設定 ] > [+ リソースの追加 ] をクリックし、リソースの種類を選択します。

    UI での SQLウェアハウスのアプリ リソースの追加

  2. リソースのタイプに応じて、リソースの設定に必要なフィールド ( リソースキー フィールドなど) を入力します。 このキーは、後でリソースを参照するために使用されます。

  3. [ 保存 ]をクリックします。

  4. SQLウェアハウス リソース キーを使用して、app.yaml 構成ファイルにリソースのエントリを追加します。これは実際の値ではなくパラメーター値のソースを参照しているため、valueの代わりに valueFrom を使用します。

    YAML
    env:
    - name: 'DATABRICKS_WAREHOUSE_ID'
    valueFrom: 'sql-warehouse'
  5. アプリ コードでリソースを参照するには、 name フィールドの値 (この例ではDATABRICKS_WAREHOUSE_ID ) を使用して、構成されたキー値を参照します。

    Python
    import os

    os.getenv('DATABRICKS_WAREHOUSE_ID')

SQLウェアハウス エンドポイントやモデル サービング エンドポイントなど、アプリでリソースを使用するその他の例については、アプリ作成時のテンプレートの例とベスト プラクティス: シークレットを使用してDatabricksアプリの機密情報を格納する方法をご覧ください。

Databricks アプリの詳細を表示する

Databricks アプリの詳細ページを表示するには:

  1. サイドバーのコンピュートアイコンコンピュート ]をクリックします。
  2. [アプリ ] タブに移動します。
  3. [ 名前 ] 列で、アプリ名をクリックします。
  4. [ 概要 ] タブが表示され、アプリのステータス、デプロイ場所、関連リソースなど、アプリの詳細が表示されます。
    • アプリのデプロイ履歴にアクセスするには、[ デプロイ ] タブに移動します。
    • アプリのログを表示するには、[ ログ ] タブに移動します。
    • 環境変数やインストール済みパッケージなど、アプリのランタイム環境を表示するには、[ 環境 ] タブに移動します。

Databricks アプリのアクセス許可を構成する

アプリの権限を管理するには、 CAN MANAGE または IS OWNER の権限が必要です。

  1. アプリの詳細ページで、[ 権限] をクリックします。
  2. [権限設定 ] で、[ ユーザー、グループ、またはサービスプリンシパルの選択 ] ドロップダウンメニューを選択し、ユーザー、グループ、サービスプリンシパル、またはすべてのワークスペースユーザーを選択します。
  3. 権限のドロップダウンメニューから権限を選択します。
  4. [ 追加 ] をクリックし、[ 保存 ] をクリックします。

Databricks アプリの状態の維持

アプリがメモリに保持している状態は、再起動すると失われます。 アプリで再起動間で状態を維持する必要がある場合は、状態を外部に保存します。 たとえば、アプリでは Databricks SQLワークスペース ファイルまたは Unity Catalog ボリューム を使用して状態を保持できます。

Databricks アプリからのログ記録

注記

Databricks Apps UI またはアプリの URL でログを表示するには、アプリで stdoutstderrにログを記録する必要があります。

アプリの標準出力と標準エラーを表示するには、アプリの詳細ページで [ログ ] タブをクリックします。 「Databricks アプリの詳細を表示する」を参照してください。

<appurl>/logzリンクで標準出力ログと標準エラーログを表示することもできます。たとえば、アプリの URL が https://my-app-1234567890.my-instance.databricksapps.comの場合、 https://my-app-1234567890.my-instance.databricksapps.com/logzでログを表示できます。 アプリの URL を見つけるには、アプリの詳細ページに移動します。

Databricks アプリのライブラリ依存関係の指定

デプロイと共に自動的にインストールされるパッケージ以外の Python ライブラリがアプリに必要な場合は、 requirements.txt ファイルを使用してそれらのライブラリを定義します。 requirements.txtファイル内のパッケージが自動的にインストールされたパッケージの 1 つと重複している場合、requirements.txt内のバージョンが自動的にインストールされたパッケージよりも優先されます。

アプリのデプロイの一部としてインストールされるパッケージとバージョンの一覧については、「 インストールされている Python ライブラリ」を参照してください。

Databricks アプリにはどのような HTTP ヘッダーが渡されますか?

次の X-Forwarded-* ヘッダーは、Databricks アプリのリバース プロキシからアプリに渡されます。

header説明
X-Forwarded-Hostクライアントによって要求された元のホストまたはドメイン。
X-Forwarded-Preferred-UsernameIdPから提供されたユーザー名。
X-Forwarded-UserIdP によって提供されるユーザー識別子。
X-Forwarded-EmailIdPが提供するユーザーEメール。
X-Real-Ip元の要求を行ったクライアントの IP アドレス。
X-Request-IdリクエストのUUID。

Databricks Apps ではどのようなフレームワークがサポートされていますか?

ほとんどの Python フレームワークを使用してアプリを開発できます。 Dash、Gradio、Streamlitなどの特定のフレームワークの使用例を表示するには、UIで新しいアプリを作成するときにテンプレートアプリのライブラリから選択します。 「Databricks Apps UI でアプリを作成するにはどうすればよいですか?」を参照してください。

Databricks Apps ランタイム環境で設定される Streamlit 固有の変数については、Stream の デフォルト 環境変数 を参照してください。

ベスト プラクティス: シークレットを使用して Databricks アプリの機密情報を保存する

Databricks では、シークレットを使用して、認証資格情報などの機密情報を格納することをお勧めします。 シークレットの使用の詳細については、「 シークレットの管理」を参照してください

アプリでシークレットを使用するには:

  1. シークレットを アプリ リソースとして構成します。

    UI でのシークレットをアプリ リソースとして追加する

  2. アプリの app.yaml 設定ファイルにシークレットのエントリを追加します。

    YAML
    env:
    - name: 'API_TOKEN'
    valueFrom: 'api-token-value'
  3. アプリコードのシークレットを参照するには、name フィールドの値(この例では API_TOKEN)を使用して、設定されたキー値を参照します。

Python
token = os.getenv('API_TOKEN')

ベスト プラクティス: Databricks の機能を使用してデータ処理を行う

Databricks Apps コンピュートは、UI を提供するために設計されています。 アプリが複数のユーザーを効率的にサポートできるようにするには、Databricks の機能を使用して、単純なデータ処理以外のことを行う必要があります。 たとえば、クエリ処理とデータセットの保存には a Databricks SQL 、データ処理には Databricks ジョブ、 AI モデルのクエリにはモデルサービングを使用します。

ベストプラクティス:安全なコーディングのベストプラクティスに従う

Databricks では、アプリを開発するときに、SQL インジェクション攻撃を回避するためのクエリのパラメーター化など、安全なコーディング プラクティスに従うことをお勧めします。 ステートメント実行 API を参照してください。

Databricks アプリの実装に関する重要なガイドライン

  • Databricks アプリはSIGTERMの 15 秒後にSIGKILLシグナルを送信するため、アプリはSIGTERMシグナルを受信してから 15 秒以内に正常にシャットダウンする必要があります。アプリが 15 秒経過しても終了しない場合は、 SIGKILL シグナルが送信され、プロセスとすべての子プロセスが終了します。
  • Databricks アプリは特権のないシステム ユーザーとして実行されるため、ルート ユーザーのアクセス許可が必要な操作など、特権セキュリティ コンテキストでの実行が必要な操作は実行できません。
  • リクエストはリバースプロキシから転送されるため、アプリはリクエストの発信元に依存しないようにする必要があります。 Databricks アプリ環境では、サポートされているフレームワークに必要な構成パラメーターが設定されます。
  • Databricks アプリ フレームワークはトランスポート層セキュリティ (TLS) 接続を管理するため、アプリで TLS 接続やハンドシェイク操作を実行してはなりません。
  • アプリは、HTTP/2 クリアテキスト (H2C) 形式の要求を処理するように実装する必要があります。
  • Databricks アプリは、 0.0.0.0 で HTTP サーバーをホストし、 DATABRICKS_APP_PORT 環境変数で指定されたポート番号を使用する必要があります。 環境変数を参照してください。