備註
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
service-principals-v2
Databricks CLI 中的指令群組允許您管理服務主體身份，用於工作、自動化工具及系統，如腳本、應用程式和 CI/CD 平台。 Databricks 建議建立服務主體來執行生產作業或修改生產資料。
Databricks Service-Principals-V2 Create
在 Databricks 工作區中建立新的服務主體。
databricks service-principals-v2 create [flags]
Arguments
沒有
選項
--active
如果這位服務負責人仍在職。
--application-id string
與服務主體相關的 UUID。
--display-name string
字串，表示指定和系列名稱的串連。
--external-id string
服務主體的外部標識碼。
--id string
Databricks 服務主體標識符。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
範例
以下範例會建立一個新的服務主體：
databricks service-principals-v2 create --display-name "my-service-principal"
DataBricks Service-Principals-V2 Delete
從 Databricks 工作空間中刪除一個服務主體。
databricks service-principals-v2 delete ID [flags]
Arguments
ID
Databricks 工作區中服務主體的唯一標識符。
選項
範例
以下範例刪除了一個服務主體：
databricks service-principals-v2 delete 12345678
Databricks Service-Principals-V2 Get
取得 Databricks 工作區中定義之單一服務主體的詳細數據。
databricks service-principals-v2 get ID [flags]
Arguments
ID
Databricks 工作區中服務主體的唯一標識符。
選項
範例
以下範例可取得服務主體的詳細資訊：
databricks service-principals-v2 get 12345678
Databricks Service-Principals-V2 列表
取得與 Databricks 工作區相關的服務主體集合。
databricks service-principals-v2 list [flags]
Arguments
沒有
選項
--attributes string
要以逗號分隔的屬性清單，以回應傳回。
--count int
每個頁面所需的結果數目。
--excluded-attributes string
在回應中排除的屬性清單，以逗號分隔。
--filter string
透過查詢來篩選結果。
--sort-by string
排序結果的屬性。
--sort-order ListSortOrder
排序結果的順序。 支援的值：ascending、descending
--start-index int
指定第一個結果的索引。
範例
下列範例會列出所有服務主體：
databricks service-principals-v2 list
DataBricks Service-Principals-V2 補丁
部分更新 Databricks 工作區中單一服務主體的詳細數據。
databricks service-principals-v2 patch ID [flags]
Arguments
ID
Databricks 工作區中的唯一 ID。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
範例
以下範例是利用 JSON 檔案修補服務主體：
databricks service-principals-v2 patch 12345678 --json @patch.json
DataBricks Service-Principals-V2 更新
更新單一服務主體的詳細數據。 此動作會將相同名稱的現有服務主體替換掉。
databricks service-principals-v2 update ID [flags]
Arguments
ID
Databricks 服務主體標識符。
選項
--active
如果這位服務負責人仍在職。
--application-id string
與服務主體相關的 UUID。
--display-name string
字串，表示指定和系列名稱的串連。
--external-id string
服務主體的外部標識碼。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
範例
以下範例更新服務主體的顯示名稱：
databricks service-principals-v2 update 12345678 --display-name "updated-service-principal"
全域旗標
--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 字串
如果適用，要使用的套件組合目標