Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明,包括任何使用數據條款。
recipients
Databricks CLI 中的指令群組包含管理 Unity 目錄中共享接收者的指令。 請參閱 What is Delta Sharing?。
databricks 收件者創建
在中繼資料庫中建立具有"Delta Sharing"認證類型的新接收者。 呼叫端必須是中繼存放區管理員,或具有 CREATE_RECIPIENT 中繼存放區的許可權。
databricks recipients create NAME AUTHENTICATION_TYPE [flags]
Arguments
NAME
收件者的名稱。
AUTHENTICATION_TYPE
增量共享驗證類型。 支援的值:DATABRICKS、、OAUTH_CLIENT_CREDENTIALS、 OIDC_FEDERATIONTOKEN
選項
--comment string
收件者的描述。
--data-recipient-global-metastore-id string
數據收件者提供的全域 Unity 目錄中繼存放區標識碼。
--expiration-time int
令牌的到期時間戳,以 epoch 毫秒為單位。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--owner string
收件者擁有者的用戶名稱。
--sharing-code string
數據收件者提供的一次性共享程序代碼。
databricks 收件者刪除
從中繼存放區刪除指定的收件者。 呼叫端必須是收件者的擁有者。
databricks recipients delete NAME [flags]
Arguments
NAME
收件者的名稱。
選項
databricks 收件者取得
若符合下列條件,請從中繼存放區獲取共用收件者:
- 呼叫者是共用收件者的擁有者,
- 或是 Metastore 管理員。
databricks recipients get NAME [flags]
Arguments
NAME
收件者的名稱。
選項
databricks 收件者清單
請列出目前中繼資料存放區中的所有分享對象:
- 呼叫者是中繼存放區管理員,
- 或呼叫方是擁有者。
不保證陣列中的元素有特定的順序。
databricks recipients list [flags]
Arguments
None
選項
--data-recipient-global-metastore-id string
如果未提供,則會傳回所有收件者。
--max-results int
要傳回的收件者數目上限。
--page-token string
不透明分頁令牌會根據上一個查詢移至下一頁。
databricks 收件者輪替令牌
使用提供的令牌資訊更新指定接收者的 Delta Sharing 認證令牌。 呼叫端必須是收件者的擁有者。
databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]
Arguments
NAME
收件者的名稱。
EXISTING_TOKEN_EXPIRE_IN_SECONDS
ISO 8601 格式持有人令牌的到期時間。 這僅能將現有令牌的過期時間設定為較早的時間戳,而不能延長過期時間。 使用 0 立即過期現有的令牌,負數會傳回錯誤。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
databricks 收件者更新
將現有的收件者資料更新至中繼存放區。 呼叫端必須是中繼存放區管理員或收件者的擁有者。 如果收件者名稱將會更新,用戶必須是中繼存放區管理員和收件者的擁有者。
databricks recipients update NAME [flags]
Arguments
NAME
收件者的名稱。
選項
--comment string
收件者的描述。
--expiration-time int
令牌的到期時間戳,以 epoch 毫秒為單位。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--new-name string
收件者的新名稱。
--owner string
收件者擁有者的用戶名稱。
databricks 收件者共享許可權
取得指定收件者的共享許可權。 呼叫端必須是中繼存放區管理員或收件者的擁有者。
databricks recipients share-permissions NAME [flags]
Arguments
NAME
收件者的名稱。
選項
--max-results int
返回的許可權數目上限。
--page-token string
不透明分頁令牌會根據上一個查詢移至下一頁。
全域旗標
--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 字串
如果適用,要使用的套件組合目標