備註
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
account groups
Databricks CLI 中的指令群組包含執行建立、取得、列出、更新及刪除群組操作的指令。 群組簡化了身份管理，使得對 Databricks 帳號、資料及其他可保護物件的存取權限更為容易。 請參閱 群組。
DataBricks 帳號群組建立
在 Databricks 帳號中建立一個新群組，並使用唯一名稱。
databricks account groups create [flags]
選項
--display-name string
字串，表示人類可讀取的組名。
--external-id string
團體的外部識別碼。
--id string
Databricks 群組標識符。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例使用命令列旗標建立一個群組：
databricks account groups create --display-name "Data Scientists"
以下範例使用 JSON 建立一個群組：
databricks account groups create --json '{"displayName": "Data Scientists", "externalId": "ds-group-001"}'
以下範例使用 JSON 檔案建立一個群組：
databricks account groups create --json @group.json
Databricks 帳號群組刪除
從 Databricks 帳號刪除一個群組。
databricks account groups delete ID [flags]
Arguments
ID
Databricks 帳號中某群組的唯一 ID。
選項
範例
下列範例會依識別碼刪除群組：
databricks account groups delete 12345
Databricks 帳戶群組取得
在 Databricks 帳號中取得特定群組的資訊。
databricks account groups get ID [flags]
Arguments
ID
Databricks 帳號中某群組的唯一 ID。
選項
範例
以下範例可依 ID 得到一個群組：
databricks account groups get 12345
Databricks 帳號群組列表
取得與 Databricks 帳號相關群組的所有詳細資訊。
這很重要
截至 2025/08/22，此指令不再返回成員。 成員應該透過透過 Get 群組資料反覆搜尋來取得。
databricks account groups list [flags]
選項
--attributes string
要以逗號分隔的屬性清單，以回應傳回。
--count int
每個頁面所需的結果數目。
--excluded-attributes string
在回應中排除的屬性清單，以逗號分隔。
--filter string
透過查詢來篩選結果。
--sort-by string
排序結果的屬性。
--sort-order ListSortOrder
排序結果的順序。 支援的值：ascending、descending。
--start-index int
指定第一個結果的索引。
範例
下列範例會列出所有群組：
databricks account groups list
下列範例會列出具有分頁的群組：
databricks account groups list --count 10 --start-index 0
以下範例列出帶有過濾器的群組：
databricks account groups list --filter "displayName eq \"Data Scientists\""
Databricks 帳號群組修補程式
部分更新群組的詳細數據。
databricks account groups patch ID [flags]
Arguments
ID
Databricks 工作區中的唯一 ID。
選項
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例是用 JSON 修補群組：
databricks account groups patch 12345 --json '{"displayName": "Updated Group Name"}'
以下範例是使用 JSON 檔案修補一群：
databricks account groups patch 12345 --json @patch-group.json
Databricks 帳號群組更新
藉由取代整個群組實體來更新群組的詳細數據。
databricks account groups update ID [flags]
Arguments
ID
Databricks 群組標識符。
選項
--display-name string
字串，表示人類可讀取的組名。
--external-id string
團體的外部識別碼。
--id string
Databricks 群組標識符。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例是使用命令列旗標更新群組：
databricks account groups update 12345 --display-name "Updated Data Scientists"
下列範例會使用 JSON 更新群組：
databricks account groups update 12345 --json '{"displayName": "Updated Data Scientists", "externalId": "ds-group-002"}'
以下範例使用 JSON 檔案更新群組：
databricks account groups update 12345 --json @update-group.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 字串
如果適用，要使用的套件組合目標