注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明,包括任何数据使用规定。
workspace-bindings
Databricks CLI 中的命令组包含用于在 Unity 目录中配置(绑定)安全对象的命令。 Databricks 中的安全对象可以配置为 OPEN
或 ISOLATED
.
OPEN
可以从任何工作区访问安全对象,而ISOLATED
安全对象只能从配置的工作区列表中访问。
支持绑定的安全对象类型:catalog
、、storage_credential
credential
external_location
。
databricks 工作区绑定查询
获取目录的工作区绑定信息。 调用方必须是元存储管理员或目录的所有者。
databricks workspace-bindings get NAME [flags]
论据
NAME
目录的名称。
选项
例子
以下示例获取目录的工作区绑定信息:
databricks workspace-bindings get my_catalog
databricks workspace-bindings get-bindings
获取可保护对象的工作区绑定。 调用方必须是元存储管理员或安全对象的所有者。
databricks workspace-bindings get-bindings SECURABLE_TYPE SECURABLE_NAME [flags]
论据
SECURABLE_TYPE
要绑定到工作区的可保护对象的类型(目录、存储凭证、凭据或外部位置)。
SECURABLE_NAME
安全对象的名称。
选项
--max-results int
要返回的最大工作区绑定数。
--page-token string
不透明分页令牌根据上一个查询转到下一页。
例子
以下示例获取目录的工作区绑定信息:
databricks workspace-bindings get-bindings catalog my_catalog
以下示例展示如何获取存储凭据的工作区绑定,并支持分页功能:
databricks workspace-bindings get-bindings storage_credential my_storage_credential --max-results 10
以下示例获取外部位置的工作区绑定:
databricks workspace-bindings get-bindings external_location my_external_location
databricks 工作区绑定更新
更新目录的工作区绑定。 调用方必须是元存储管理员或目录的所有者。
databricks workspace-bindings update NAME [flags]
论据
NAME
目录的名称。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
例子
以下示例使用 JSON 更新目录的工作区绑定:
databricks workspace-bindings update my_catalog --json '{"bindings": [{"workspace_id": 123456789, "binding_type": "BINDING_TYPE_READ_WRITE"}]}'
以下示例使用 JSON 文件更新工作区绑定:
databricks workspace-bindings update my_catalog --json @bindings.json
databricks workspace-bindings update-bindings
更新可保护对象的工作区绑定关系。 调用方必须是元存储管理员或安全对象的所有者。
databricks workspace-bindings update-bindings SECURABLE_TYPE SECURABLE_NAME [flags]
论据
SECURABLE_TYPE
要绑定到工作区的可保护对象的类型(目录、存储凭证、凭据或外部位置)。
SECURABLE_NAME
安全对象的名称。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
例子
以下示例演示如何更新目录中工作区的绑定:
databricks workspace-bindings update-bindings catalog my_catalog --json '{"bindings": [{"workspace_id": 123456789, "binding_type": "BINDING_TYPE_READ_WRITE"}]}'
全局标志
--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
字符串
如果适用,要使用的捆绑包目标