Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
storage-credentials
Databricks CLI 中的指令群組包含管理 Unity 目錄中儲存憑證的指令。 記憶體認證代表用來存取雲端租使用者上所儲存數據的驗證和授權機制。 每個記憶體認證都受限於 Unity 目錄存取控制原則，以控制哪些使用者和群組可以存取認證。 如果使用者無法存取 Unity Catalog 中的儲存憑證，請求將會失敗，Unity Catalog 不會嘗試代表使用者向您的雲端租戶進行驗證。 請參閱 管理記憶體認證。
Databricks storage-credentials create
建立新的記憶體認證。
呼叫端必須是中繼存放區管理員，或具有 CREATE_STORAGE_CREDENTIAL 中繼存放區的許可權。
databricks storage-credentials create NAME [flags]
Arguments
NAME
認證名稱。 名稱在資料存取庫中的存儲和服務憑證之間必須是唯一的。
選項
--comment string
與認證相關聯的批注。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--read-only
認證是否僅適用於讀取作業。
--skip-validation
提供 true 給這個自變數會略過所建立認證的驗證。
Examples
下列範例會建立新的記憶體認證：
databricks storage-credentials create my-storage-credential
下列範例會建立具有註解的儲存憑證：
databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"
下列範例會建立唯讀記憶體認證：
databricks storage-credentials create my-storage-credential --read-only
databricks storage-credentials delete（刪除資料儲存憑證的指令）
從元資料庫刪除儲存憑證。 呼叫端必須是記憶體認證的擁有者。
databricks storage-credentials delete NAME [flags]
Arguments
NAME
記憶體認證的名稱。
選項
--force
強制更新，即使目的為 STORAGE 時有相依的外部位置或外部數據表，或目的為 SERVICE 時有相依服務。
Examples
下列範例會刪除記憶體認證：
databricks storage-credentials delete my-storage-credential
下列範例會強制刪除記憶體認證：
databricks storage-credentials delete my-storage-credential --force
databricks storage-credentials get（用於獲取存儲憑證的命令）
從中繼資料庫取得儲存憑證。 呼叫端必須是中繼存放區管理員、記憶體認證的擁有者，或具有記憶體認證的某些許可權。
databricks storage-credentials get NAME [flags]
Arguments
NAME
記憶體認證的名稱。
選項
Examples
下列範例會取得儲存認證的相關資訊：
databricks storage-credentials get my-storage-credential
databricks storage-credentials 清單
列出記憶體認證。 清單僅限於呼叫端有權存取的那些記憶體認證。 如果呼叫端是中繼存放區管理員，則認證擷取不受限制。 不保證陣列中的元素有特定的順序。
databricks storage-credentials list [flags]
選項
--max-results int
要傳回的記憶體認證數目上限。
--page-token string
不透明分頁令牌會根據上一個查詢移至下一頁。
Examples
下列範例會列出所有記憶體認證：
databricks storage-credentials list
Databricks 存取憑證更新
更新中繼存放區上的記憶體認證。
呼叫端必須是記憶體認證或中繼存放區管理員的擁有者。如果呼叫端是中繼存放區管理員，則只能 owner 變更欄位。
databricks storage-credentials update NAME [flags]
Arguments
NAME
記憶體認證的名稱。
選項
--comment string
與認證相關聯的批注。
--force
即使有相依關係的外部位置或外部表格，仍強制更新。
--isolation-mode IsolationMode
當前的安全性實體是否可供所有工作區或特定的一組工作區存取。 支援的值：[ISOLATION_MODE_ISOLATED，ISOLATION_MODE_OPEN]
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--new-name string
記憶體認證的新名稱。
--owner string
目前認證擁有者的用戶名稱。
--read-only
認證是否僅適用於讀取作業。
--skip-validation
提供 true 給這個自變數會略過更新認證的驗證。
Examples
下列範例會更新儲存憑證的註解：
databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"
下列範例會變更記憶體認證的擁有者：
databricks storage-credentials update my-storage-credential --owner someone@example.com
下列範例會重新命名記憶體認證：
databricks storage-credentials update my-storage-credential --new-name updated-credential
databricks storage-credentials validate（用於驗證儲存憑證的命令）
驗證記憶體認證。 至少需要提供 external_location_name 和 url 中的一個。 如果只提供其中一個，則會用於驗證。 如果兩者都提供， url 則會用於驗證，並在 external_location_name 檢查重疊的 URL 時予以忽略。
必須提供storage_credential_name 或雲端特定認證中的任一項。
呼叫端必須是中繼存放區管理員或記憶體認證擁有者，或具有 CREATE_EXTERNAL_LOCATION 中繼存放區和記憶體認證的許可權。
databricks storage-credentials validate [flags]
選項
--external-location-name string
要驗證的現有外部位置名稱。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--read-only
記憶體認證是否只能用於讀取作業。
--storage-credential-name string
Required.
--url string
要驗證的外部位置 URL。
Examples
下列範例會根據外部位置驗證記憶體認證：
databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location
下列範例會根據 URL 驗證記憶體認證：
databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path
全域旗標
--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 字串
如果適用，要使用的套件組合目標