次の方法で共有


Databricks Apps 環境

Databricks アプリは、次のバイナリとリソースを含むマネージド環境で実行されます。

  • オペレーティング システム: Ubuntu 22.04 LTS
  • Python 環境: 専用の仮想環境で実行されている Python 3.11。 すべての依存関係は、この環境内で分離されます。 uvを使用するアプリでは、別の Python バージョンを指定できます。 Databricks アプリの依存関係の管理に関するページを参照してください。
  • uv バージョン: 0.10.2
  • Node.js 環境: バージョン 22.16 Node.js。 npmpackage.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_PORTGRADIO_SERVER_NAME=0.0.0.0
Streamlit STREAMLIT_SERVER_PORTSTREAMLIT_SERVER_ADDRESS=0.0.0.0
FastAPI UVICORN_PORTUVICORN_HOST=0.0.0.0
Uvicorn UVICORN_PORTUVICORN_HOST=0.0.0.0
Flask FLASK_RUN_PORTFLASK_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 ファイル内のすべての依存関係を明示的に一覧表示する必要があります。