備註
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
account workspaces
Databricks CLI 中的指令群組包含管理您帳戶工作空間的指令。 Databricks 工作區是一個用來存取所有 Databricks 資產的環境。 工作區將物件（筆記本、函式庫與實驗）組織到資料夾中，並提供資料與計算資源（如叢集與工作）的存取。 請參閱 建立工作區。
備註
如果你的帳號使用的是 E2 版本平台，或是選擇允許每個帳號擁有多個工作區的自訂方案，這些指令都可以使用。
Databricks 帳號工作區建立
建立一個新工作區，使用憑證配置與儲存設定、選用網路設定（若使用客戶管理的 VPC）、選用的管理服務金鑰設定（若使用客戶管理的金鑰管理服務），以及可選的儲存金鑰配置（若使用客戶管理的金鑰作為儲存）。
這很重要
這項作業是異步的。 帶有 HTTP 狀態碼 200 的回應表示請求已被接受且正在進行中，但不代表工作區已成功部署並正在執行。 初始工作區狀態通常是 PROVISIONING。 請在回應中使用 workspace ID （workspace_id） 欄位來識別新工作區，並 GET 多次請求並檢查其狀態。 當狀態變為執行中時，工作區才會開放。
databricks account workspaces create [flags]
選項
--workspace-name string
這個工作區的人類可讀名稱。
--deployment-name string
部署名稱定義了工作空間子網域的一部分。
--aws-region string
Workspace 的 AWS 區域。
--cloud string
雲端名稱。
--location string
你 Google 帳戶 Workspace 資料平面的 Google Cloud 區域（例如， us-east4）。
--credentials-id string
工作區憑證設定物件的識別碼。
--storage-configuration-id string
工作區儲存配置物件的識別碼。
--network-id string
工作空間的網路設定物件的 ID。
--managed-services-customer-managed-key-id string
工作空間的受管服務加密金鑰設定物件的 ID。
--storage-customer-managed-key-id string
工作區的儲存加密金鑰配置物件的 ID。
--private-access-settings-id string
工作區私有存取設定物件的 ID。
--network-connectivity-config-id string
網路連接設定的物件 ID。
--compute-mode CustomerFacingComputeMode
若計算模式為無伺服器，則建立無伺服器工作空間。 支援的值：HYBRID、SERVERLESS。
--pricing-tier PricingTier
工作空間的價格層級。 支援值：COMMUNITY_EDITION， DEDICATED， ENTERPRISE， STANDARDPREMIUMUNKNOWN。
--no-wait
不要等到達到「運行」狀態。
--timeout duration
達到運行狀態的最大時間（預設 20 分鐘）。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例使用 JSON 建立一個工作區：
databricks account workspaces create --json '{"workspace_name": "my-workspace", "deployment_name": "my-workspace-deployment", "aws_region": "us-west-2", "credentials_id": "cred-abc123", "storage_configuration_id": "storage-xyz789"}'
以下範例使用 JSON 檔案建立工作區：
databricks account workspaces create --json @workspace.json
以下範例建立一個帶有命令列旗標的工作區：
databricks account workspaces create --workspace-name "my-workspace" --deployment-name "my-workspace-deployment" --aws-region "us-west-2" --credentials-id "cred-abc123" --storage-configuration-id "storage-xyz789"
Databricks 帳號工作區刪除
刪除由 ID 指定的 Databricks 工作區。
databricks account workspaces delete WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
工作空間唯一的整數 ID。
選項
範例
以下範例是依 ID 刪除工作區：
databricks account workspaces delete 123456789
Databricks 帳戶工作區會得到
取得包括 Data Bricks 工作空間狀態在內的資訊，由 ID 指定。 在回應中，欄位 workspace_status 顯示目前狀態。 在初始建立工作區（非同步）後， GET 重複請求工作區 ID 並檢查其狀態。 當狀態變為執行中時，工作區才會開放。
databricks account workspaces get WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
工作空間唯一的整數 ID。
選項
範例
以下範例依 ID 取得工作區：
databricks account workspaces get 123456789
Databricks 帳號工作區列表
列出帳號的 Databricks 工作區。
databricks account workspaces list [flags]
選項
範例
以下範例列出所有工作區：
databricks account workspaces list
Databricks 帳戶工作區更新
更新工作區設定。
databricks account workspaces update WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
工作空間唯一的整數 ID。
選項
--workspace-name string
這個工作區的人類可讀名稱。
--deployment-name string
工作空間的部署名稱。
--aws-region string
Workspace 的 AWS 區域。
--cloud string
雲端名稱。
--location string
你 Google 帳戶 Workspace 資料平面的 Google Cloud 區域（例如， us-east4）。
--credentials-id string
工作區憑證設定物件的識別碼。
--storage-configuration-id string
工作區儲存配置物件的識別碼。
--network-id string
如果這個工作區是自帶 VPC，那麼network_id就會被填入。
--managed-services-customer-managed-key-id string
加密受管服務的金鑰配置識別碼。
--storage-customer-managed-key-id string
加密工作空間儲存的金鑰配置 ID。
--private-access-settings-id string
工作區私有存取設定物件的 ID。
--network-connectivity-config-id string
網路連接設定的物件 ID。
--expected-workspace-status WorkspaceStatus
客戶擁有的欄位用來表示客戶端預期會處於的工作區狀態。 支援值：BANNED， CANCELLING， FAILED， PROVISIONINGNOT_PROVISIONEDRUNNING。
--update-mask string
欄位遮罩必須是單一字串，並以逗號分隔多個字段（無空格）。
--no-wait
不要等到達到「運行」狀態。
--timeout duration
達到運行狀態的最大時間（預設 20 分鐘）。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例更新工作區名稱：
databricks account workspaces update 123456789 --workspace-name "updated-workspace-name"
以下範例使用 JSON 更新工作區：
databricks account workspaces update 123456789 --json '{"workspace_name": "updated-workspace-name", "credentials_id": "cred-new123"}'
以下範例使用 JSON 檔案更新工作區：
databricks account workspaces update 123456789 --json @update-workspace.json
全域旗標
--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 字串
如果適用，要使用的套件組合目標