Databricks アプリは、次のバイナリとリソースを含むマネージド環境で実行されます。
- オペレーティング システム: Ubuntu 22.04 LTS
-
Python 環境: 専用の仮想環境で実行されている Python 3.11。 すべての依存関係は、この環境内で分離されます。
uvを使用するアプリでは、別の Python バージョンを指定できます。 Databricks アプリの依存関係の管理に関するページを参照してください。 - uv バージョン: 0.10.2
-
Node.js 環境: バージョン 22.16 Node.js。
npmとpackage.jsonを使用して依存関係を管理します。 - システム リソース: 既定では、各アプリは最大 2 つの仮想 CPU (vCPU) と 6 GB のメモリを使用できます。 ワークロードの要件に基づいて CPU とメモリの割り当てを調整するようにコンピューティング サイズを構成します。 Databricks アプリのコンピューティング サイズの構成に関するページを参照してください。
環境の詳細を表示する
環境変数やインストールされているパッケージなど、特定のアプリの環境を表示するには、アプリの詳細ページの [環境] タブに移動します。 「Databricks アプリの詳細を確認する」を参照してください。
既定の環境変数
すべてのアプリで次の環境変数を使用できます。
| 変数 | 説明 |
|---|---|
DATABRICKS_APP_NAME |
実行中のアプリの名前。 |
DATABRICKS_WORKSPACE_ID |
アプリが属する Databricks ワークスペースの一意の ID。 |
DATABRICKS_HOST |
アプリが属する Databricks ワークスペースの URL。 |
DATABRICKS_APP_PORT |
アプリがリッスンする必要があるネットワーク ポート。 |
DATABRICKS_CLIENT_ID |
アプリに割り当てられている Databricks サービス プリンシパルのクライアント ID。 |
DATABRICKS_CLIENT_SECRET |
アプリに割り当てられている Databricks サービス プリンシパルの OAuth シークレット。 |
アプリ テレメトリ環境変数
アプリのテレメトリを有効にすると、Azure Databricks によってアプリ ランタイムで次の環境変数が自動的に構成されます。
| 変数 | 価値 | 説明 |
|---|---|---|
OTEL_EXPORTER_OTLP_ENDPOINT |
http://localhost:4314 |
OTLP コレクター エンドポイント |
OTEL_EXPORTER_OTLP_PROTOCOL |
grpc |
エクスポート プロトコル |
OTEL_RESOURCE_ATTRIBUTES |
workspace.id=<id>,app.name=<name> |
トレース コンテキストのリソース属性 |
OTEL_SERVICE_NAME |
<your_app_name> |
テレメトリ データのサービス名 |
OTEL_BSP_MAX_QUEUE_SIZE |
10000 |
スパン キューの最大サイズ |
OTEL_BLRP_MAX_QUEUE_SIZE |
10000 |
ログ キューの最大サイズ |
OTEL_BSP_MAX_EXPORT_BATCH_SIZE |
512 |
スパン エクスポートのバッチ サイズ |
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE |
512 |
ログ エクスポートのバッチ サイズ |
OTEL_BSP_SCHEDULE_DELAY |
1000 |
スパン エクスポート間隔 (ミリ秒) |
OTEL_BLRP_SCHEDULE_DELAY |
1000 |
ログ のエクスポート間隔 (ミリ秒) |
アプリテレメトリの構成の詳細については、「 Databricks Apps のテレメトリを構成する」を参照してください。
フレームワーク環境変数
Databricks Apps ランタイムは、サポートされている Python フレームワークのポート変数とホスト変数を自動的に設定します。 これらを手動で構成する必要はありません。 すべてのポート変数は、 DATABRICKS_APP_PORTの値に設定されます。
| フレームワーク | 変数 |
|---|---|
| Gradio |
GRADIO_SERVER_PORT、GRADIO_SERVER_NAME=0.0.0.0 |
| Streamlit |
STREAMLIT_SERVER_PORT、STREAMLIT_SERVER_ADDRESS=0.0.0.0 |
| FastAPI |
UVICORN_PORT、UVICORN_HOST=0.0.0.0 |
| Uvicorn |
UVICORN_PORT、UVICORN_HOST=0.0.0.0 |
| Flask |
FLASK_RUN_PORT、FLASK_RUN_HOST=0.0.0.0 |
| ダッシュ | PORT |
| 簡易 | PORT |
追加の Streamlit 環境変数
ランタイムは、次の Streamlit 固有の変数も設定します。
| 変数 | 説明 |
|---|---|
STREAMLIT_SERVER_ENABLE_XSRF_PROTECTION |
false に設定します。 Databricks Apps リバース プロキシは XSRF 保護を処理します。 |
STREAMLIT_SERVER_ENABLE_CORS |
false に設定します。 Databricks Apps リバース プロキシは CORS を処理します。 |
STREAMLIT_SERVER_HEADLESS |
ブラウザー ウィンドウを開かずに Streamlit が実行されるように、 true に設定します。 |
STREAMLIT_BROWSER_GATHER_USAGE_STATS |
使用統計を Streamlit に送信しないようにするには、 false に設定します。 |
Databricks Apps 環境には、Node.js ライブラリはプレインストールされていません。 Node.js アプリの場合は、実行時にインストールされるように、 package.json ファイル内のすべての依存関係を明示的に一覧表示する必要があります。