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

Databricks Apps の使用を開始する

この記事では、Databricks のベスト プラクティスに従ったテンプレートを使用して Databricks ワークスペースに簡単なアプリを作成する手順の例を使用して、Databricks アプリの使用を開始する方法について説明します。

この例では、次の操作について説明します。

  • テンプレートからのアプリの作成
  • デプロイ後のアプリの表示
  • アプリテンプレートをコンピューターにコピーしてさらに開発する
  • アプリをローカルで実行する
  • ワークスペースへのアプリの再デプロイ

この記事の終わりまでに、アプリをローカルで反復処理し、Databricks に更新プログラムをデプロイできるようになります。

前提 条件​

このチュートリアルを完了する前に、Databricks ワークスペースとローカル開発環境が正しく構成されていることを確認してください。「 Databricks アプリのワークスペースと開発環境を設定する」を参照してください。

ステップ 1: 依存関係をインストールする​

ターミナルを開き、次のコマンドを実行して次の操作を行います。

  • サンプル アプリに必要な Python ライブラリをインストールします。
  • アプリのソースファイルと設定ファイル用のローカルディレクトリを作成します。
Bash
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world は、アプリ ファイルのローカル ディレクトリです。

ステップ 2: アプリを作成する​

  1. Databricks ワークスペースで、左側のサイドバーにある [+ 新しい > アプリ ] をクリックします。

  2. [ テンプレートからインストール ] で、[ Gradio ] タブに移動します。

  3. Hello world テンプレートを選択します。

    Hello World テンプレートを選択します

  4. アプリに gradio-hello-world という名前を付けて 、[インストール] をクリックします。

これにより、選択したテンプレートに基づいて新しいアプリが作成され、ワークスペースにデプロイされます。

ステップ 3: アプリを表示する​

アプリを作成すると、アプリが自動的に起動し、プレビューに使用できる URL が表示されます。アプリの URL とデプロイの状態は、 [概要 ] ページで確認できます。

アプリ展開後にアプリの詳細ページを見る

URLをクリックしてアプリを表示します。

hello world アプリの出力をローカルで表示する

ステップ4:アプリをコンピューターにコピーする​

アプリを作成したら、ソース コードをローカル コンピューターにダウンロードしてカスタマイズできます。

  1. [Sync the files ] の下の最初のコマンドをコピーします。

    アプリの作成後にアプリの詳細ページを表示する

  2. ターミナルで、作成した gradio-hello-world ローカルディレクトリに移動し、コピーした sync コマンドを実行します。

    Bash
    databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app .

    ...
    Export complete

    このコマンドは、 app.py と app.yamlという名前のディレクトリに 2 つの新しいファイルをコピーします。app.yaml は、エントリ ポイントやアクセス許可など、アプリの構成を定義します。app.py には、アプリの機能とユーザー インターフェイスを実装するコードが含まれています。

手順 5: アプリをローカルで変更してテストする​

  1. 必要に応じて、アプリをローカルでカスタマイズして開発します。たとえば、 app.py を変更してデータをインタラクティブにしたり、テーマやスタイル設定オプションを追加したり、データのアップロードを許可したりできます。

  2. アプリをテストするには、次のコマンドを実行します python app.py。

    Bash
    python app.py

    Running on local URL:  http://127.0.0.1:7860
    ...

  3. アプリを表示するには、ブラウザー ウィンドウで [ http://127.0.0.1:7860 ] に移動します。

  4. 必要に応じて、 databricks apps 実行-local コマンドを使用して 、アプリを実行およびデバッグします。

    Bash
    databricks apps run-local --prepare-environment --debug

    このコマンドは、すべての依存関係をインストールし、仮想環境を準備してから、ポート 5678 でアプリとデバッガーを起動します。[ http://localhost:8001 ] に移動してアプリを表示します。

    Visual Studio Code でブレークポイントを設定するには、Python デバッガー拡張機能をインストールしてから、 リモートアタッチ >デバッグの実行 > 開始 に移動します。

手順 6: アプリをワークスペースに再デプロイする​

アプリを再デプロイするには、アプリの詳細ページの [Databricks アプリへのデプロイ ] でコマンドをコピーします。

コマンドをコピーしてアプリをデプロイする

gradio-hello-world ローカル ディレクトリ内からコマンドを実行します。

このコマンドは、次の操作で成功します。

JSON
{
  "create_time": "2025-06-09T19:36:50Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/1234abcd-5678-90ab-cdef-123456abcdef/src/abcd1234efgh5678ijkl9012mnop3456"
  },
  "deployment_id": "abcd1234efgh5678ijkl9012mnop3456",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2025-06-09T19:36:51Z"
}

デプロイの状態を表示するには、アプリの [概要 ] ページに移動します。

次のステップ​

最初のアプリをデプロイしてカスタマイズしたので、次のことができます。

  • 認証を設定して 、アプリにアクセスして編集できるユーザーを管理します。
  • アプリを Databricks シークレットや Databricks SQL などの Databricks プラットフォーム機能と統合します。
  • ワークスペース内または組織全体の他のユーザーとアプリを共有します。
  • さまざまなフレームワークと機能を備えたエクスペリメントへのより多くのアプリ テンプレートを探索してください。
に最終更新