Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
environments
Databricks CLI 中的指令群組允許你管理環境資源。 環境 API 提供不同類型的環境管理能力，包括定義無伺服器筆記本與工作中使用的環境版本與相依性的工作區層基環境。
Databricks 環境 create-workspace-base-environment
建立一個新的工作空間基礎環境。 這是一種長時間執行的操作，非同步產生物質化環境以優化相依性解析。
databricks environments create-workspace-base-environment DISPLAY_NAME [flags]
引數
DISPLAY_NAME
工作空間基礎環境的可讀顯示名稱。
選項
--base-environment-type BaseEnvironmentType
基礎環境的類型（CPU 或 GPU）。 支援的值：CPU、GPU
--filepath string
工作區檔案或 Unity 目錄卷的路徑會連接到環境的 YAML 檔案。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--name string
工作空間基礎環境的資源名稱。
--no-wait
不要等到進入 DONE 州賽。
--request-id string
此要求的唯一識別碼。
--timeout duration
達到 DONE 州的最長時間。
--workspace-base-environment-id string
用於工作空間基礎環境的 ID，該 ID 將成為資源名稱的最終元件。
Examples
以下範例建立一個 CPU 工作空間的基底環境：
databricks environments create-workspace-base-environment "My Python Env" --base-environment-type CPU --filepath /Workspace/environments/env.yaml
DataBricks 環境 Delete-Workspace-Base-Environment
刪除一個工作區基礎環境。 刪除基地環境可能會影響連結的筆記本和工作。 此作業無法復原。
databricks environments delete-workspace-base-environment NAME [flags]
引數
NAME
必須的。 要刪除的工作區基礎環境的資源名稱。 格式：workspace-base-environments/{workspace_base_environment}。
選項
Examples
以下範例刪除了一個工作空間基底環境：
databricks environments delete-workspace-base-environment workspace-base-environments/my-env-id
Databricks 環境 GET-DEFAULT-WORKSPACE-BASE-ENVIRONMENT
取得預設的工作區基礎環境設定。 回傳 CPU 和 GPU 運算的預設基礎環境設定。
databricks environments get-default-workspace-base-environment NAME [flags]
引數
NAME
預設工作空間基礎環境的靜態資源名稱。 格式：default-workspace-base-environment。
選項
Examples
以下範例取得預設的工作區基礎環境：
databricks environments get-default-workspace-base-environment default-workspace-base-environment
Databricks 環境 GET-操作
取得長期營運的狀態。 用戶端可以使用此方法輪詢操作結果。
databricks environments get-operation NAME [flags]
引數
NAME
這個行動資源的名稱。
選項
Examples
以下範例獲得長期執行操作的狀態：
databricks environments get-operation operations/1234567890
Databricks 環境 Get-Workspace-Base-Environment
請直接用一個工作空間基礎環境。
databricks environments get-workspace-base-environment NAME [flags]
引數
NAME
必須的。 要取回的工作空間基礎環境資源名稱。 格式：workspace-base-environments/{workspace_base_environment}。
選項
Examples
以下範例獲得工作空間基礎環境：
databricks environments get-workspace-base-environment workspace-base-environments/my-env-id
Databricks 環境列表-工作空間-基礎環境
在工作區中列出所有工作空間的基礎環境。
databricks environments list-workspace-base-environments [flags]
引數
None
選項
--page-size int
每頁可返回的最大環境數量。
--page-token string
頁面標記用於分頁。
Examples
以下範例列出所有工作區基底環境：
databricks environments list-workspace-base-environments
Databricks 環境 refresh-workspace-base-environment
將實體化環境刷新為工作空間基礎環境。 這是一個長期運作的操作，會非同步地再生物質化的環境。 現有的物質化環境會持續使用直到它結束。
databricks environments refresh-workspace-base-environment NAME [flags]
引數
NAME
必須的。 工作區基礎環境的資源名稱來刷新。 格式：workspace-base-environments/{workspace_base_environment}。
選項
--no-wait
不要等到進入 DONE 州賽。
--timeout duration
達到 DONE 州的最長時間。
Examples
以下範例刷新工作區基底環境：
databricks environments refresh-workspace-base-environment workspace-base-environments/my-env-id
Databricks 環境更新-預設-工作空間-基礎環境
更新預設的工作區基礎環境設定。 將指定的基礎環境設定為工作區的 CPU 和/或 GPU 運算預設值。
databricks environments update-default-workspace-base-environment NAME UPDATE_MASK [flags]
引數
NAME
這個單例資源的資源名稱。 格式：default-workspace-base-environment。
UPDATE_MASK
欄位遮罩指定要更新哪些欄位。 有效場路徑： cpu_workspace_base_environment， gpu_workspace_base_environment。 用來 * 更新所有欄位。
選項
--cpu-workspace-base-environment string
CPU 運算的預設工作空間基礎環境。
--gpu-workspace-base-environment string
GPU 運算的預設工作空間基礎環境。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--name string
這個單例資源的資源名稱。
Examples
以下範例設定了預設的 CPU 工作空間基礎環境：
databricks environments update-default-workspace-base-environment default-workspace-base-environment cpu_workspace_base_environment --cpu-workspace-base-environment workspace-base-environments/my-cpu-env
Databricks 環境更新-工作空間-基礎環境
更新現有的工作區基礎環境。 這是一個長期運作的操作，會非同步地再生物質化的環境。 現有的物質化環境會持續使用直到它結束。
databricks environments update-workspace-base-environment NAME DISPLAY_NAME [flags]
引數
NAME
工作空間基礎環境的資源名稱。 格式：workspace-base-environments/{workspace_base_environment}。
DISPLAY_NAME
工作空間基礎環境的可讀顯示名稱。
選項
--base-environment-type BaseEnvironmentType
基礎環境的類型（CPU 或 GPU）。 支援的值：CPU、GPU
--filepath string
工作區檔案或 Unity 目錄磁碟區路徑到環境的 YAML 檔案。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--name string
工作空間基礎環境的資源名稱。
--no-wait
不要等到進入 DONE 州賽。
--timeout duration
達到 DONE 州的最長時間。
Examples
以下範例更新了一個工作空間的基礎環境：
databricks environments update-workspace-base-environment workspace-base-environments/my-env-id "Updated Python Env" --filepath /Workspace/environments/updated-env.yaml
全域旗標
--debug
是否要啟用偵錯記錄。
-h 或 --help
顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。
--log-file 字串
字串，表示要寫入輸出記錄檔的檔案。 若未指定此旗標，則預設值是將輸出記錄寫入 stderr。
--log-format 格式
記錄格式類型，text 或 json。 預設值為 text。
--log-level 字串
表示日誌格式層級的字串。 若未指定，則日誌的格式層級功能將被停用。
-o, --output 類型
指令輸出類型，text 或 json。 預設值為 text。
-p, --profile 字串
用於執行命令的~/.databrickscfg檔案中的配置檔名稱。 如果未指定此旗標，則如果存在，則會使用名為 DEFAULT 的配置檔。
--progress-format 格式
顯示進度記錄的格式：default、、appendinplace、 或json
-t, --target 字串
如果適用，要使用的套件組合目標