注释
此信息适用于 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]
论据
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 字符串
如果适用，要使用的捆绑包目标