この記事では、Azure Databricks のベスト プラクティスに従うテンプレートを使用して、Azure Databricks ワークスペースに単純なアプリを作成する手順の例を使用して、Databricks Apps の使用を開始する方法について説明します。
この例では、次の手順を実行します。
- テンプレートからのアプリの作成
- アプリを展開した後に表示する
- アプリ テンプレートをコンピューターにコピーして開発を進める
- アプリをローカルで実行する
- アプリをワークスペースに再デプロイする
この記事の終わりまでに、アプリをローカルで反復処理し、更新プログラムを Databricks にデプロイできるようになります。
[前提条件]
このチュートリアルを完了する前に、Azure Databricks ワークスペースとローカル開発環境が正しく構成されていることを確認してください。 Databricks Apps ワークスペースと開発環境を設定するを参照してください。
手順 1: 依存関係をインストールする
ターミナルを開き、次のコマンドを実行して次のコマンドを実行します。
- サンプル アプリに必要な Python ライブラリをインストールします。
- アプリのソース ファイルと構成ファイルのローカル ディレクトリを作成します。
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world
gradio-hello-world は、アプリ ファイルのローカル ディレクトリです。
手順 2: アプリを作成する
Databricks ワークスペースで、左側のサイドバーで [ + 新規>App ] をクリックします。
Gradio Hello world テンプレートを選択します。
アプリに gradio-hello-world という名前を 付け、[ インストール] をクリックします。
これにより、選択したテンプレートに基づいて新しいアプリが作成され、ワークスペースにデプロイされます。
手順 3: アプリを表示する
アプリを作成すると、アプリが自動的に開始され、プレビューに使用できる URL が表示されます。 [ 概要 ] ページでアプリの URL とデプロイの状態を表示します。
URL をクリックしてアプリを表示します。
Azure Databricks では、アプリ名とワークスペース ID に基づいてアプリの URL が自動的に生成されます。 アプリの作成後に URL を変更することはできません。 別の URL が必要な場合は、別の名前で新しいアプリを作成します。 詳細については、「 アプリの URL」を参照してください。
手順 4: アプリをコンピューターにコピーする
アプリを作成したら、ソース コードをローカル コンピューターにダウンロードしてカスタマイズできます。
[ファイルの同期] の下 にあるコマンドをコピーします。
ターミナルで、作成した
gradio-hello-worldローカル ディレクトリに移動し、コピーしたコマンドを実行します。databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app . ... Export complete gradio-hello-world % databricks sync --watch . /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app ... Initial Sync Complete最初のコマンドは、ワークスペースからローカル ディレクトリ (
app.py、app.yaml、requirements.txt) に 3 つのファイルをエクスポートします。 2 番目のコマンドは、ローカル ファイルの変更を監視し、ワークスペースに自動的にアップロードする同期プロセスを開始します。-
app.pyには、アプリの機能とユーザー インターフェイスを実装するコードが含まれています。 -
app.yamlは、エントリ ポイントとアクセス許可を含むアプリの構成を定義します。 -
requirements.txtには、アプリに必要な Python パッケージが一覧表示されます。
-
手順 5: アプリをローカルで変更してテストする
必要に応じて、アプリをローカルでカスタマイズして開発します。 たとえば、
app.pyを変更してデータを対話形式にしたり、テーマやスタイルオプションを追加したり、データのアップロードを許可したりできます。アプリをテストするには、
python app.pyを実行します。python app.py Running on local URL: http://127.0.0.1:7860 ...アプリを表示するには、ブラウザー ウィンドウで
http://127.0.0.1:7860に移動します。必要に応じて、 databricks アプリの run-local コマンド を使用して、アプリを実行およびデバッグします。
databricks apps run-local --prepare-environment --debugこのコマンドは、すべての依存関係をインストールし、仮想環境を準備してから、ポート 5678 でアプリとデバッガーを起動します。
http://localhost:8001に移動してアプリを表示します。Visual Studio Code でブレークポイントを設定するには、Python デバッガー拡張機能をインストールし、 実行>デバッグの開始>Remote Attach に移動します。
手順 6: アプリをワークスペースに再デプロイする
アプリを再デプロイするには、アプリの概要ページの [Databricks Apps にデプロイ ] の下のコマンドをコピーします。
gradio-hello-worldローカル ディレクトリ内からコマンドを実行します。
コマンドは成功します。
{
"create_time": "2026-02-03T23:25:38Z",
"creator": "my-email@org.com",
"deployment_artifacts": {
"source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
},
"deployment_id": "01f10157a60a113e980014bebd5f4a03",
"mode": "SNAPSHOT",
"source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app",
"status": {
"message": "App started successfully",
"state": "SUCCEEDED"
},
"update_time": "2026-02-03T23:25:41Z"
}
デプロイの状態を表示するには、アプリの [概要 ] ページに移動します。
次のステップ
最初のアプリをデプロイしてカスタマイズしたら、次のことができます。