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 grants command group within the Databricks CLI allows you to manage grants. 在 Unity 目录中，数据默认是安全的。 最初，用户无权访问元存储中的数据。 可以通过元存储管理员、对象的所有者或包含该对象的目录或架构的所有者授予访问权限。 请参阅 “显示”、“授予”和“撤销权限”。
databricks 授予获取
获取安全对象的权限。 不包括继承的权限。
databricks grants get SECURABLE_TYPE FULL_NAME [flags]
Arguments
SECURABLE_TYPE
安全对象的类型。
FULL_NAME
安全对象的完整名称。
选项
--max-results int
指定要返回的最大权限数（页长度）。
--page-token string
不透明分页令牌根据上一个查询转到下一页。
--principal string
如果提供，则仅返回指定主体（用户或组）的权限。
Examples
以下示例获取目录的权限：
databricks grants get catalog my_catalog
以下示例获取特定主体的权限：
databricks grants get catalog my_catalog --principal someone@example.com
以下示例获取具有分页的权限：
databricks grants get table my_catalog.my_schema.my_table --max-results 10
databricks 授予 get-effective
获取安全对象的有效权限。 包括从任何父安全对象继承的权限。
databricks grants get-effective SECURABLE_TYPE FULL_NAME [flags]
Arguments
SECURABLE_TYPE
安全对象的类型。
FULL_NAME
安全对象的完整名称。
选项
--max-results int
指定要返回的最大权限数（页长度）。
--page-token string
结果下一页的不透明令牌（分页）。
--principal string
如果提供，则仅返回指定主体（用户或组）的有效权限。
Examples
以下示例获取表的有效权限：
databricks grants get-effective table my_catalog.my_schema.my_table
以下示例获取特定主体的有效权限：
databricks grants get-effective schema my_catalog.my_schema --principal someone@example.com
以下示例获取分页的有效权限：
databricks grants get-effective catalog my_catalog --max-results 20 --page-token abc123
databricks 授予更新
更新安全对象的权限。
databricks grants update SECURABLE_TYPE FULL_NAME [flags]
Arguments
SECURABLE_TYPE
安全对象的类型。
FULL_NAME
安全对象的完整名称。
选项
--json JSON
内联 JSON 字符串或 @path 包含请求正文的 JSON 文件的 JSON 文件。
Examples
以下示例使用 JSON 文件更新权限：
databricks grants update catalog my_catalog --json @permissions.json
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 格式
显示进度日志的格式： default、 append、 inplace或 json
-t, --target 字符串
如果适用，要使用的捆绑包目标