recipients 命令组

recipients Databricks CLI 中的命令组包含用于管理 Unity 目录中共享收件人的命令。 请参阅什么是 Delta Sharing？。

databricks 收件人创建

在元存储中创建具有增量共享身份验证类型的新收件人。 调用方必须是元存储管理员或具有 CREATE_RECIPIENT 元存储的权限。

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

论据

NAME

    收件人姓名。

AUTHENTICATION_TYPE

    增量共享身份验证类型。 支持的值：DATABRICKS、OAUTH_CLIENT_CREDENTIALS、OIDC_FEDERATION、TOKEN

选项

--comment string

    有关收件人的说明。

--data-recipient-global-metastore-id string

    数据接收方提供的全局 Unity Catalog 元数据存储 ID。

--expiration-time int

    令牌的过期时间戳（以纪元毫秒为单位）。

--json JSON

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

--owner string

    收件人所有者的用户名。

--sharing-code string

    数据接收者提供的一次性共享代码。

全局标志

databricks 收件人删除

从元存储中删除指定的收件人。 呼叫方必须是收件人的所有者。

databricks recipients delete NAME [flags]

论据

NAME

    收件人的名称。

选项

全局标志

databricks 收件人获取

从元存储获取共享收件人（如果：

• 调用者是共享接收者的所有者，
• 或是元存储管理员。

databricks recipients get NAME [flags]

论据

NAME

    收件人的名称。

选项

全局标志

databricks 收件人列表

列出当前元存储中的所有共享收件人，其中：

• 调用方是元存储管理员，
• 或调用方是所有者。

不能保证数组中元素的特定排序。

databricks recipients list [flags]

论据

没有

选项

--data-recipient-global-metastore-id string

    如果未提供，将返回所有收件人。

--max-results int

    要返回的最大收件人的数量。

--page-token string

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

全局标志

databricks 收件人轮换令牌

使用提供的令牌信息轮换指定的收件人的增量共享身份验证令牌。 呼叫方必须是收件人的所有者。

databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]

论据

NAME

    收件人的名称。

EXISTING_TOKEN_EXPIRE_IN_SECONDS

    持有者令牌的过期时间（采用 ISO 8601 格式）。 这将仅将现有令牌的“expiration_time”设置为较小的时间戳，因此无法延长“expiration_time”。 使用 0 立即使现有令牌过期，任何负数将返回错误。

选项

--json JSON

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

全局标志

databricks 收件人更新

更新元存储中的现有收件人。 调用方必须是元存储管理员或收件人的所有者。 如果收件人名称将更新，则用户必须是元存储管理员和收件人的所有者。

databricks recipients update NAME [flags]

论据

NAME

    收件人的名称。

选项

--comment string

    有关收件人的说明。

--expiration-time int

    令牌的过期时间戳（以纪元毫秒为单位）。

--json JSON

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

--new-name string

    收件人的新名称。

--owner string

    收件人所有者的用户名。

全局标志

databricks 收件人共享权限

获取指定收件人的共享权限。 调用方必须是元存储管理员或收件人的所有者。

databricks recipients share-permissions NAME [flags]

论据

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

-t, --target 字符串

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