storage-credentials 命令组

storage-credentials Databricks CLI 中的命令组包含用于管理 Unity 目录中存储凭据的命令。 存储凭据表示用于访问存储在云租户中的数据的身份验证和授权机制。 每个存储凭据都受 Unity 目录访问控制策略的约束，这些策略控制哪些用户和组可以访问凭据。 如果用户无权访问 Unity 目录中的存储凭据，请求将失败，Unity 目录不会代表用户尝试向云租户进行身份验证。 请参阅管理存储凭据。

databricks storage-credentials create

创建新的存储凭据。

调用方必须是元存储管理员或具有 CREATE_STORAGE_CREDENTIAL 元存储的权限。

databricks storage-credentials create NAME [flags]

论据

NAME

    凭据名称。 该名称在元存储中的存储和服务凭据中必须是唯一的。

选项

--comment string

    与凭据关联的注释。

--json JSON

    内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。

--read-only

    凭据是否仅可用于读取操作。

--skip-validation

    提供 true 值给此参数将跳过对已创建凭据的验证。

全局标志

例子

以下示例创建新的存储凭据：

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 存储凭证删除

从元存储中删除存储凭据。 调用方必须是存储凭据的所有者。

databricks storage-credentials delete NAME [flags]

论据

NAME

    存储凭据的名称。

选项

--force

    即使目的为STORAGE时存在依赖的外部位置或外部表，或目的为SERVICE时存在依赖服务，也要强制更新。

全局标志

例子

以下示例删除存储凭据：

databricks storage-credentials delete my-storage-credential

以下示例强制删除存储凭据：

databricks storage-credentials delete my-storage-credential --force

databricks 存储凭证获取

从元存储获取存储凭据。 调用方必须是元存储管理员、存储凭据的所有者，或者对存储凭据具有某些权限。

databricks storage-credentials get NAME [flags]

论据

NAME

    存储凭据的名称。

选项

全局标志

例子

以下示例获取有关存储凭据的信息：

databricks storage-credentials get my-storage-credential

databricks storage-credentials 列表

列出存储凭据。 该列表仅限于调用方有权访问的那些存储凭据。 如果调用方是元存储管理员，则不限制检索凭据。 不能保证数组中元素的特定排序。

databricks storage-credentials list [flags]

选项

--max-results int

    返回的最大存储凭据数量。

--page-token string

    不透明分页令牌根据上一个查询转到下一页。

全局标志

例子

以下示例列出所有存储凭据：

databricks storage-credentials list

databricks存储凭证更新

更新 metastore 上的存储凭据。

调用方必须是存储凭据的所有者或是元存储管理员。如果调用方是元存储管理员，则只能更改 owner 字段。

databricks storage-credentials update NAME [flags]

论据

NAME

    存储凭据的名称。

选项

--comment string

    与凭据关联的注释。

--force

    强制更新，尤其在存在依赖的外部位置或外部表的情况下。

--isolation-mode IsolationMode

    当前安全对象是否可以从所有工作区或一组特定的工作区访问。 支持的值：[ISOLATION_MODE_ISOLATED，ISOLATION_MODE_OPEN]

--json JSON

    内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。

--new-name string

    存储凭据的新名称。

--owner string

    凭据的当前所有者的用户名。

--read-only

    凭据是否仅可用于读取操作。

--skip-validation

    为此参数提供 true 会跳过更新凭据的验证。

全局标志

例子

以下示例更改存储凭据的所有者：

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 字符串或包含请求正文的 JSON 文件中的 @path。

--read-only

    存储凭据是否仅可用于读取操作。

--storage-credential-name string

    必填。

--url string

    要验证的外部位置 URL。

全局标志

例子

以下示例针对外部位置验证存储凭据：

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、 append、 inplace或 json

-t, --target 字符串

    如果适用，要使用的捆绑包目标