recipients 命令组

Note

此信息适用于 Databricks CLI 版本 0.205 及更高版本。 The Databricks CLI is in Public Preview.

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

The recipients command group within the Databricks CLI contains commands to manage share recipients in Unity Catalog. 请参阅什么是 Delta Sharing?

databricks 收件人创建

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

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    收件人姓名。

AUTHENTICATION_TYPE

    增量共享身份验证类型。 支持的值: DATABRICKSOAUTH_CLIENT_CREDENTIALS、、 OIDC_FEDERATIONTOKEN

选项

--comment string

    有关收件人的说明。

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

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

--expiration-time int

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

--json JSON

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

--owner string

    收件人所有者的用户名。

--sharing-code string

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

Global flags

databricks 收件人删除

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

databricks recipients delete NAME [flags]

Arguments

NAME

    收件人的名称。

选项

Global flags

databricks 收件人获取

从元存储获取共享收件人(如果:

  • 调用方是共享收件人的所有者,
  • 或是元存储管理员。
databricks recipients get NAME [flags]

Arguments

NAME

    收件人的名称。

选项

Global flags

databricks 收件人列表

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

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

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

databricks recipients list [flags]

Arguments

None

选项

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

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

--max-results int

    要返回的最大收件人数。

--page-token string

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

Global flags

databricks 收件人轮换令牌

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

databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]

Arguments

NAME

    收件人的名称。

EXISTING_TOKEN_EXPIRE_IN_SECONDS

    持有者令牌的过期时间(采用 ISO 8601 格式)。 这将仅将现有令牌expiration_time设置为较小的时间戳,因此无法扩展expiration_time。 使用 0 立即使现有令牌过期,负数将返回错误。

选项

--json JSON

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

Global flags

databricks 收件人更新

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

databricks recipients update NAME [flags]

Arguments

NAME

    收件人的名称。

选项

--comment string

    有关收件人的说明。

--expiration-time int

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

--json JSON

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

--new-name string

    收件人的新名称。

--owner string

    收件人所有者的用户名。

Global flags

databricks 收件人共享权限

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

databricks recipients share-permissions NAME [flags]

Arguments

NAME

    收件人的名称。

选项

--max-results int

    要返回的最大权限数。

--page-token string

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

Global flags

Global flags

--debug

  是否启用调试日志记录。

-h--help

    显示 Databricks CLI、相关命令组或相关命令的帮助。

--log-file 字符串

    一个字符串,表示要将输出日志写入到的文件。 如果未指定此标志,则默认会将输出日志写入到 stderr。

--log-format 格式

    日志格式类型或 textjson。 默认值是 text

--log-level 字符串

    一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。

-o, --output 类型

    命令输出类型或 textjson。 默认值是 text

-p, --profile 字符串

    用于运行命令的文件中配置文件 ~/.databrickscfg 的名称。 如果未指定此标志,则如果存在,则使用命名 DEFAULT 的配置文件。

--progress-format 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

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