storage-credentials 命令群組

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 字串

    如果適用，要使用的套件組合目標