clean-room-assets 命令组

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 clean-room-assets command group within the Databricks CLI allows you to manage clean room assets. 清理室资产是与清理室共享的数据和对象,例如表、卷和笔记本。 支持的资产类型包括FOREIGN_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

databricks clean-room-assets create

创建干净的房间资产。 对于通过此方法添加的每个 Unity 目录资产,清理室所有者还必须对资产拥有足够的权限才能使用它。 必须无限期地保留特权,以便清理室能够访问资产。 通常,应使用组作为清理室所有者。

databricks clean-room-assets create CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

选项

--asset-type CleanRoomAssetAssetType

    资产的类型。 支持的值:FOREIGN_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

--json JSON

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

--name string

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

Global flags

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 clean-room-assets delete

删除干净房间资产。 取消共享,并从清理室中删除资产。

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

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

ASSET_TYPE

    资产的类型。 支持的值:FOREIGN_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

NAME

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

选项

Global flags

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_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

NAME

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

选项

Global flags

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

    不透明分页令牌根据上一个查询转到下一页。

Global flags

Examples

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

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

databricks clean-room-assets update

更新干净房间资产。 例如,更新笔记本的内容或更改表的共享分区。

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

Arguments

CLEAN_ROOM_NAME

    清洁室的名称。

ASSET_TYPE

    资产的类型。 支持的值:FOREIGN_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

NAME

    一个完全限定的名称,用于唯一标识清理室中的资产。 这也是在干净房间 UI 中显示的名称。 对于 Unity 目录安全资产(表、卷等),格式为 shared_catalog.shared_schema.asset_name。 对于笔记本,名称是笔记本文件名。

选项

--asset-type CleanRoomAssetAssetType

    资产的类型。 支持的值:FOREIGN_TABLE、、NOTEBOOK_FILETABLEVIEWVOLUME

--json JSON

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

--name string

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

Global flags

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"

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 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

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