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_FILE
TABLE
和VIEW
VOLUME
。
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_FILE
、TABLE
VIEW
、VOLUME
--json JSON
内联 JSON 字符串或 @path 包含请求正文的 JSON 文件的 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 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_FILE
、TABLE
VIEW
、VOLUME
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_TABLE
、、NOTEBOOK_FILE
、TABLE
VIEW
、VOLUME
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 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_FILE
、TABLE
VIEW
、VOLUME
NAME
一个完全限定的名称,用于唯一标识清理室中的资产。 这也是在干净房间 UI 中显示的名称。 对于 Unity 目录安全资产(表、卷等),格式为 shared_catalog.shared_schema.asset_name
。 对于笔记本,名称是笔记本文件名。
选项
--asset-type CleanRoomAssetAssetType
资产的类型。 支持的值:FOREIGN_TABLE
、、NOTEBOOK_FILE
、TABLE
VIEW
、VOLUME
--json JSON
内联 JSON 字符串或 @path 包含请求正文的 JSON 文件的 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"
Global flags
--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
字符串
如果适用,要使用的捆绑包目标