共用方式為


Databricks Apps 環境

您的 Databricks 應用程式運行於受管理環境中,使用以下二進位檔與資源:

  • 操作系統: Ubuntu 22.04 LTS
  • Python 環境: Python 3.11,運行在專用虛擬環境中。 所有依賴性在此環境中都是隔離的。 使用這些的 uv 應用程式可以指定不同的 Python 版本。 請參閱 管理 Databricks 應用程式的相依性
  • UV 版本: 0.10.2
  • Node.js 環境: Node.js 版本 22.16。 使用 npmpackage.json管理相依性。
  • 系統資源: 預設情況下,每個應用程式最多可使用2個虛擬CPU(vCPU)及6 GB記憶體。 根據你的工作負載需求,設定運算大小以調整 CPU 和記憶體的分配。 請參閱 設定 Databricks 應用程式的計算大小

檢視環境詳細數據

若要檢視特定應用程式的環境,包括環境變數和已安裝的套件,請移至應用程式詳細數據頁面上的 [ 環境 ] 索引標籤。 請參閱 檢視 Databricks 應用程式的詳細數據。

默認環境變數

每個應用程式中都有下列環境變數:

變數 說明
DATABRICKS_APP_NAME 執行中應用程式的名稱。
DATABRICKS_WORKSPACE_ID 應用程式所屬 Databricks 工作區的唯一標識碼。
DATABRICKS_HOST 應用程式所屬 Databricks 工作區的 URL。
DATABRICKS_APP_PORT 應用程式應該接聽的網路埠。
DATABRICKS_CLIENT_ID 指派給應用程式的 Databricks 服務主體用戶端識別碼。
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 張幅輸出間隔(ms)
OTEL_BLRP_SCHEDULE_DELAY 1000 對數匯出間隔(ms)

欲了解更多關於設定應用程式遙測的資訊,請參閱 「為 Databricks 應用程式配置遙測」。

框架環境變數

Databricks Apps 執行時會自動設定支援的 Python 框架的埠與主機變數。 你不需要手動設定這些。 所有埠變數都設定為 的 DATABRICKS_APP_PORT值。

Framework 變數
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_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 設定為 true Streamlit 在不開啟瀏覽器視窗的情況下執行。
STREAMLIT_BROWSER_GATHER_USAGE_STATS 設定為 false 以防止傳送使用統計到 Streamlit。

Databricks Apps 環境中不會預安裝任何 Node.js 連結庫。 針對 Node.js 應用程式,您必須明確列出檔案 package.json 中的所有相依性,以確保它們會在運行時間安裝。