Note
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明,包括任何使用數據條款。
account users-v2
Databricks CLI 中的指令群組包含執行建立、取得、列舉、更新及刪除使用者操作的指令。 使用者身份由 Databricks 識別,並以電子郵件地址表示。
Databricks 建議使用 SCIM 配置,自動將使用者和群組從你的身份提供者同步到你的 Databricks 帳號。 SCIM 透過使用身份提供者在 Databricks 帳號中建立使用者和群組,並給予適當的存取權限,簡化了新員工或團隊的入職流程。 當使用者離開組織或不再需要存取 Databricks 帳號時,管理員可以在你的身份提供者中終止該使用者,該使用者的帳號也會從 Databricks 帳號中移除。 這可確保一致的下架程式,並防止未經授權的使用者存取敏感資料。 請參閱 管理使用者。
Databricks Account Users-v2 Create
在 Databricks 帳號中建立一個新使用者。
databricks account users-v2 create [flags]
選項
--active
如果此使用者處於活躍狀態。
--display-name string
字串,表示指定和系列名稱的串連。
--external-id string
目前不支援外部標識碼。
--id string
Databricks 用戶標識碼。
--json JSON
要麼是內嵌 JSON 字串,要麼 @path/to/file.json 是請求主體。
--user-name string
Databricks 用戶的電子郵件位址。
Examples
以下範例使用命令列旗標建立使用者:
databricks account users-v2 create --user-name "user@example.com" --display-name "Jane Doe"
下列範例會使用 JSON 建立使用者:
databricks account users-v2 create --json '{"userName": "user@example.com", "displayName": "Jane Doe", "active": true}'
以下範例使用 JSON 檔案建立使用者:
databricks account users-v2 create --json @user.json
Databricks Account Users-v2 刪除
從 Databricks 帳號刪除使用者。
從 Databricks 帳號刪除使用者也會移除與該使用者相關的物件。
databricks account users-v2 delete ID [flags]
Arguments
ID
Databricks 帳號中使用者的唯一 ID。
選項
Examples
下列範例會依識別碼刪除使用者:
databricks account users-v2 delete 12345
Databricks Account Users-V2 Get
在 Databricks 帳號中取得特定使用者的資訊。
databricks account users-v2 get ID [flags]
Arguments
ID
Databricks 帳號中使用者的唯一 ID。
選項
--attributes string
要以逗號分隔的屬性清單,以回應傳回。
--count int
每個頁面所需的結果數目。
--excluded-attributes string
在回應中排除的屬性清單,以逗號分隔。
--filter string
透過查詢來篩選結果。
--sort-by string
排序結果的屬性。
--sort-order GetSortOrder
排序結果的順序。 支援的值:ascending、descending。
--start-index int
指定第一個結果的索引。
Examples
以下範例以 ID 取得使用者:
databricks account users-v2 get 12345
以下範例會取得具有特定屬性的使用者:
databricks account users-v2 get 12345 --attributes "userName,displayName"
Databricks Account Users-V2 列表
取得所有與 Databricks 帳號相關用戶的詳細資料。
databricks account users-v2 list [flags]
選項
--attributes string
要以逗號分隔的屬性清單,以回應傳回。
--excluded-attributes string
在回應中排除的屬性清單,以逗號分隔。
--filter string
透過查詢來篩選結果。
--limit int
要傳回的結果數目上限。
--sort-by string
排序結果的屬性。
--sort-order ListSortOrder
排序結果的順序。 支援的值:ascending、descending。
Examples
下列範例會列出所有使用者:
databricks account users-v2 list
下列範例會列出具有分頁的使用者:
databricks account users-v2 list --limit 10
以下範例列出帶有篩選器的使用者:
databricks account users-v2 list --filter "userName eq \"user@example.com\""
Databricks Account Users-V2 補丁
在特定的使用者屬性上套用提供的作業,以部分更新用戶資源。
databricks account users-v2 patch ID [flags]
Arguments
ID
Databricks 工作區中的唯一 ID。
選項
--json JSON
要麼是內嵌 JSON 字串,要麼 @path/to/file.json 是請求主體。
Examples
以下範例是用 JSON 修補使用者:
databricks account users-v2 patch 12345 --json '{"displayName": "Jane Smith"}'
下列範例會使用 JSON 檔案修補使用者:
databricks account users-v2 patch 12345 --json @patch-user.json
Databricks 帳號 Users-V2 更新
以要求中提供的數據取代用戶的資訊。
databricks account users-v2 update ID [flags]
Arguments
ID
Databricks 用戶標識碼。
選項
--active
如果此使用者處於活躍狀態。
--display-name string
字串,表示指定和系列名稱的串連。
--external-id string
目前不支援外部標識碼。
--json JSON
要麼是內嵌 JSON 字串,要麼 @path/to/file.json 是請求主體。
--user-name string
Databricks 用戶的電子郵件位址。
Examples
以下範例使用命令列旗標更新使用者:
databricks account users-v2 update 12345 --display-name "Jane Smith" --active
下列範例會使用 JSON 更新使用者:
databricks account users-v2 update 12345 --json '{"userName": "user@example.com", "displayName": "Jane Smith", "active": true}'
以下範例使用 JSON 檔案更新使用者:
databricks account users-v2 update 12345 --json @update-user.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 字串
如果適用,要使用的套件組合目標