Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
service-principals
Databricks CLI 中的指令群組允許你管理 Databricks 工作空間中的服務主體。 請參閱 CI/CD 的服務主體。
Databricks 服務主體創建
在 Databricks 工作區中建立新的服務主體。
databricks service-principals create [flags]
選項
--active
如果此使用者處於活躍狀態。
--application-id string
與服務主體相關的 UUID。
--display-name string
字串，表示指定和系列名稱的串連。
--external-id string
服務主體的外部標識碼。
--id string
Databricks 服務主體標識符。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
Examples
下列範例會建立具有顯示名稱的服務主體：
databricks service-principals create --display-name "My Service Principal"
下列範例會使用 JSON 建立服務主體：
databricks service-principals create --json '{"display_name": "My Service Principal", "active": true}'
databricks 服務主體 刪除
刪除 Databricks 工作區中的單一服務主體。
databricks service-principals delete ID [flags]
Arguments
ID
Databricks 工作區中服務主體的唯一標識符。
選項
Examples
下列範例會依 ID 刪除服務主體：
databricks service-principals delete 12345
Databricks 服務主體取得
取得 Databricks 工作區中定義之單一服務主體的詳細數據。
databricks service-principals get ID [flags]
Arguments
ID
Databricks 工作區中服務主體的唯一標識符。
選項
Examples
下列範例會取得服務主體的詳細數據：
databricks service-principals get 12345
databricks service-principals 清單
列出與 Databricks 工作區相關聯的服務主體集。
databricks service-principals list [flags]
選項
--attributes string
要以逗號分隔的屬性清單，以回應傳回。
--count int
每個頁面所需的結果數目。
--excluded-attributes string
在回應中排除的屬性清單，以逗號分隔。
--filter string
透過查詢來篩選結果。
--sort-by string
排序結果的屬性。
--sort-order ListSortOrder
排序結果的順序。 支援的值：ascending、descending
--start-index int
指定第一個結果的索引。
Examples
下列範例會列出所有服務主體：
databricks service-principals list
下列範例會列出具有篩選的服務主體：
databricks service-principals list --filter "displayName eq 'My Service Principal'"
databricks service-principals 更新
部分更新 Databricks 工作區中單一服務主體的詳細數據。
databricks service-principals patch ID [flags]
Arguments
ID
Databricks 工作區中的唯一 ID。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
Examples
下列範例會更新服務主體：
databricks service-principals patch 12345 --json '{"display_name": "Updated Service Principal"}'
Databricks 服務主體 更新
更新單一服務主體的詳細數據。 此動作會將相同名稱的現有服務主體替換掉。
databricks service-principals update ID [flags]
Arguments
ID
Databricks 服務主體標識符。
選項
--active
如果此使用者處於活躍狀態。
--application-id string
與服務主體相關的 UUID。
--display-name string
字串，表示指定和系列名稱的串連。
--external-id string
服務主體的外部標識碼。
--id string
Databricks 服務主體標識符。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
Examples
下列範例會更新服務主體：
databricks service-principals update 12345 --display-name "Updated Service Principal" --active
全域旗標
--debug
是否要啟用偵錯記錄。
-h 或 --help
顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。
--log-file 字串
字串，表示要寫入輸出記錄檔的檔案。 若未指定此旗標，則預設值是將輸出記錄寫入 stderr。
--log-format 格式
記錄格式類型或 textjson。 預設值是 text。
--log-level 字串
表示日誌格式層級的字串。 若未指定，則日誌的格式層級功能將被停用。
-o, --output 類型
指令輸出類型或 textjson。 預設值是 text。
-p, --profile 字串
要用來執行命令之檔案中的 ~/.databrickscfg 配置檔名稱。 如果未指定此旗標，則如果存在，則會使用名為 DEFAULT 的配置檔。
--progress-format 格式
顯示進度記錄的格式：default、、appendinplace、 或json
-t, --target 字串
如果適用，要使用的套件組合目標