Databricks Apps環境

Databricksアプリは、以下のバイナリとリソースを含む管理環境で実行されます。

オペレーティングシステム: Ubuntu 22.04 LTS
Python環境： 専用の仮想環境で動作するPython 3.11。この環境内では、すべての依存関係が分離されています。uvを使用するアプリは、異なるPythonバージョンを指定できます。Databricksアプリの依存関係の管理については、「Databricksアプリの依存関係の管理」を参照してください。
UVバージョン: 0.10.2
Node.js 環境: Node.js バージョン 22.16。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シークレット。

アプリのテレメトリを有効にすると、Databricks はアプリのランタイムで次の環境変数を自動的に構成します。

変数	Value	説明
`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_PORT`, `UVICORN_HOST=0.0.0.0`
flask	`FLASK_RUN_PORT`, `FLASK_RUN_HOST=0.0.0.0`
dash	`PORT`
急行	`PORT`

ランタイムは、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 ファイル内のすべての依存関係を明示的にリストして、実行時にインストールされるようにする必要があります。