共用方式為

workspace-bindings 命令组

注释

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

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

workspace-bindings Databricks CLI 中的命令组包含用于在 Unity 目录中配置(绑定)安全对象的命令。 Databricks 中的安全对象可以配置为 OPENISOLATED. OPEN可以从任何工作区访问安全对象,而ISOLATED安全对象只能从配置的工作区列表中访问。

支持绑定的安全对象类型:catalog、、storage_credentialcredentialexternal_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 格式

    日志格式类型,textjson。 默认值是 text

--log-level 字符串

    一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。

-o, --output 类型

    命令输出类型为 textjson。 默认值是 text

-p, --profile 字符串

    要用于运行命令的 ~/.databrickscfg 文件中的配置文件名称。 如果未指定此标志,并且存在命名为 DEFAULT 的配置文件,则使用该配置文件。

--progress-format 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

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