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
增量共享身份验证类型。 支持的值:DATABRICKS、OAUTH_CLIENT_CREDENTIALS、OIDC_FEDERATION、TOKEN
选项
--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 格式
日志格式类型,text 或 json。 默认值是 text。
--log-level 字符串
一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。
-o, --output 类型
命令输出类型为text或json。 默认值是 text。
-p, --profile 字符串
~/.databrickscfg 文件中用于运行命令的配置文件的名称。 如果未指定此标志,则如果存在,将使用名为 DEFAULT 的配置文件。
--progress-format 格式
显示进度日志的格式: default、 append、 inplace或 json
-t, --target 字符串
如适用,要使用的捆绑包目标