recipients 命令组

Note

此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。

Databricks CLI 的使用须遵守 Databricks 许可Databricks 隐私声明,包括任何数据使用规定。

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

databricks 收件人创建

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

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    收件人姓名。

AUTHENTICATION_TYPE

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

选项

--comment string

    有关收件人的说明。

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

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

--expiration-time int

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

--json JSON

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

--owner string

    收件人所有者的用户名。

--sharing-code string

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

全局标志

databricks 收件人删除

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

databricks recipients delete NAME [flags]

Arguments

NAME

    收件人的名称。

选项

全局标志

databricks 收件人获取

从元存储获取共享接收者(如果:

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

Arguments

NAME

    收件人的名称。

选项

全局标志

databricks 收件人列表

列出当前元存储中的所有共享接收者(其中:

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

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

databricks recipients list [flags]

Arguments

None

选项

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

    如果未提供,将返回所有接收者。

--max-results int

    要返回的接收者的最大数量。

--page-token string

    基于先前查询转到下一页的不透明分页令牌。

全局标志

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 文件。

全局标志

databricks 收件人信息更新

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

databricks recipients update NAME [flags]

Arguments

NAME

    收件人的名称。

选项

--comment string

    有关收件人的说明。

--expiration-time int

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

--json JSON

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

--new-name string

    收件人的新名称。

--owner string

    收件人所有者的用户名。

全局标志

databricks 收件人共享权限

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

databricks recipients share-permissions NAME [flags]

Arguments

NAME

    收件人的名称。

选项

--max-results int

    最大返回权限数

--page-token string

    基于先前查询转到下一页的不透明分页令牌。

全局标志

全局标志

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

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