clean-room-assets 命令组

Note

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

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

clean-room-assets CLI 中的命令组允许管理清理室资产。 清理室资产是与清理室共享的数据和对象,例如表、卷和笔记本。 支持的资产类型包括FOREIGN_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

databricks clean-room-assets create

创建一个洁净室资产。 对于通过此方法添加的每个 Unity Catalog 资产,洁净室所有者还必须对该资产拥有足够的权限才能使用它。 洁净室要能够访问资产,必须永久保持该权限。 通常,应使用一个团队作为洁净室的负责人。

databricks clean-room-assets create CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

选项

--asset-type CleanRoomAssetAssetType

    资产的类型。 支持的值:FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

--name string

    一个完全限定的名称,用于唯一标识洁净室中的资产。

全局标志

Examples

以下示例在洁净室中创建表资产:

databricks clean-room-assets create my-clean-room --asset-type TABLE --name "catalog.schema.table_name"

以下示例在无尘室中创建笔记本资源:

databricks clean-room-assets create my-clean-room --asset-type NOTEBOOK_FILE --name "my_notebook.py"

以下示例在洁净室中创建卷资产:

databricks clean-room-assets create my-clean-room --asset-type VOLUME --name "catalog.schema.volume_name"

databricks 清理-房间-资产 删除

删除洁净室资源。 取消共享并从洁净室中移除资产。

databricks clean-room-assets delete CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

ASSET_TYPE

    资产的类型。 支持的值:FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

NAME

    资产的完全限定名称,它与 CleanRoomAsset 中的名称字段相同。

选项

全局标志

Examples

以下示例从洁净室中删除表资产:

databricks clean-room-assets delete my-clean-room TABLE "catalog.schema.table_name"

以下示例从洁净室中删除笔记本资产:

databricks clean-room-assets delete my-clean-room NOTEBOOK_FILE "my_notebook.py"

以下示例从洁净室中删除卷资产:

databricks clean-room-assets delete my-clean-room VOLUME "catalog.schema.volume_name"

databricks clean-room-assets get

按其类型和全名获取清洁室资产的详细信息。

databricks clean-room-assets get CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

ASSET_TYPE

    资产的类型。 支持的值:FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

NAME

    资产的完全限定名称,它与 CleanRoomAsset 中的名称字段相同。

选项

全局标志

Examples

以下示例获取洁净室中表资产的详细信息:

databricks clean-room-assets get my-clean-room TABLE "catalog.schema.table_name"

以下示例获取无尘室中笔记本资产的详细信息:

databricks clean-room-assets get my-clean-room NOTEBOOK_FILE "my_notebook.py"

以下示例获取洁净室中视图资产的详细信息:

databricks clean-room-assets get my-clean-room VIEW "catalog.schema.view_name"

databricks clean-room-assets 列表

列出无尘室中的资产。

databricks clean-room-assets list CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

选项

--page-token string

    基于先前查询转到下一页的不透明分页令牌。

全局标志

Examples

以下示例列出清理室中的所有资产:

databricks clean-room-assets list my-clean-room

Databricks 清洁室资产更新

更新无尘室资产。 例如,更新笔记本的内容或更改表的共享分区。

databricks clean-room-assets update CLEAN_ROOM_NAME ASSET_TYPE NAME [flags]

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

ASSET_TYPE

    资产的类型。 支持的值:FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

NAME

    一个完全限定的名称,用于唯一标识洁净室中的资产。 这也是在洁净室用户界面中显示的名称。 对于 Unity Catalog 的可安全管理资产(表、卷等),格式为 shared_catalog.shared_schema.asset_name。 对于笔记本,名称是笔记本文件名。

选项

--asset-type CleanRoomAssetAssetType

    资产的类型。 支持的值:FOREIGN_TABLENOTEBOOK_FILETABLEVIEWVOLUME

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

--name string

    一个完全限定的名称,用于唯一标识洁净室中的资产。

全局标志

Examples

以下示例更新洁净室中的表资产:

databricks clean-room-assets update my-clean-room TABLE "catalog.schema.table_name" --json '{
  "asset_type": "TABLE",
  "name": "catalog.schema.table_name"
}'

以下示例更新洁净室中的笔记本资产:

databricks clean-room-assets update my-clean-room NOTEBOOK_FILE "my_notebook.py" --name "updated_notebook.py"

全局标志

--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 字符串

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