備註
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明,包括任何使用數據條款。
account users
Databricks CLI 中的指令群組包含執行建立、取得、列舉、更新及刪除使用者操作的指令。 使用者身份由 Databricks 識別,並以電子郵件地址表示。 請參閱 管理使用者。
Databricks 使用者建立的帳號
在 Databricks 帳號中建立一個新使用者。
databricks account users create [flags]
選項
--active
如果此使用者處於活躍狀態。
--display-name string
字串,表示指定和系列名稱的串連。
--external-id string
外部 ID(目前不支援)。
--id string
Databricks 用戶標識碼。
--user-name string
Databricks 用戶的電子郵件位址。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例使用命令列旗標建立使用者:
databricks account users create --user-name "user@example.com" --display-name "Jane Doe"
下列範例會使用 JSON 建立使用者:
databricks account users create --json '{"userName": "user@example.com", "displayName": "Jane Doe", "active": true}'
以下範例使用 JSON 檔案建立使用者:
databricks account users create --json @user.json
Databricks 帳號使用者刪除
從 Databricks 帳號刪除使用者。 刪除使用者也會移除與該使用者相關的物件。
databricks account users delete ID [flags]
Arguments
ID
Databricks 帳號中使用者的唯一 ID。
選項
範例
下列範例會依識別碼刪除使用者:
databricks account users delete 12345
Databricks 帳號用戶獲得
在 Databricks 帳號中取得特定使用者的資訊。
databricks account users 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
指定第一個結果的索引。
範例
以下範例以 ID 取得使用者:
databricks account users get 12345
以下範例會取得具有特定屬性的使用者:
databricks account users get 12345 --attributes "userName,displayName"
Databricks 帳號使用者名單
取得所有與 Databricks 帳號相關用戶的詳細資料。
databricks account users list [flags]
選項
--attributes string
要以逗號分隔的屬性清單,以回應傳回。
--count int
每個頁面所需的結果數目。
--excluded-attributes string
在回應中排除的屬性清單,以逗號分隔。
--filter string
透過查詢來篩選結果。
--sort-by string
排序結果的屬性。
--sort-order ListSortOrder
排序結果的順序。 支援的值:ascending、descending。
--start-index int
指定第一個結果的索引。
範例
下列範例會列出所有使用者:
databricks account users list
下列範例會列出具有分頁的使用者:
databricks account users list --count 10 --start-index 0
以下範例列出帶有篩選器的使用者:
databricks account users list --filter "userName eq \"user@example.com\""
Databricks 帳號使用者修補程式
在特定的使用者屬性上套用提供的作業,以部分更新用戶資源。
databricks account users patch ID [flags]
Arguments
ID
Databricks 工作區中的唯一 ID。
選項
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例是用 JSON 修補使用者:
databricks account users patch 12345 --json '{"displayName": "Jane Smith"}'
下列範例會使用 JSON 檔案修補使用者:
databricks account users patch 12345 --json @patch-user.json
Databricks 帳號使用者更新
以要求中提供的數據取代用戶的資訊。
databricks account users update ID [flags]
Arguments
ID
Databricks 用戶標識碼。
選項
--active
如果此使用者處於活躍狀態。
--display-name string
字串,表示指定和系列名稱的串連。
--external-id string
外部 ID(目前不支援)。
--id string
Databricks 用戶標識碼。
--user-name string
Databricks 用戶的電子郵件位址。
--json JSON
內嵌 JSON 字串或 @path 指向 JSON 檔案的要求本文
範例
以下範例使用命令列旗標更新使用者:
databricks account users update 12345 --display-name "Jane Smith" --active
下列範例會使用 JSON 更新使用者:
databricks account users update 12345 --json '{"userName": "user@example.com", "displayName": "Jane Smith", "active": true}'
以下範例使用 JSON 檔案更新使用者:
databricks account users 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 字串
如果適用,要使用的套件組合目標