Note
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明,包括任何数据使用规定。
clean-room-assets
CLI 中的命令组允许管理清理室资产。 清理室资产是与清理室共享的数据和对象,例如表、卷和笔记本。 支持的资产类型包括FOREIGN_TABLE、、NOTEBOOK_FILETABLE和VIEWVOLUME。
databricks clean-room-assets create
创建一个洁净室资产。 对于通过此方法添加的每个 Unity Catalog 资产,洁净室所有者还必须对该资产拥有足够的权限才能使用它。 洁净室要能够访问资产,必须永久保持该权限。 通常,应使用一个团队作为洁净室的负责人。
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 文件。
--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_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 清洁室资产更新
更新无尘室资产。 例如,更新笔记本的内容或更改表的共享分区。
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
一个完全限定的名称,用于唯一标识洁净室中的资产。 这也是在洁净室用户界面中显示的名称。 对于 Unity Catalog 的可安全管理资产(表、卷等),格式为 shared_catalog.shared_schema.asset_name。 对于笔记本,名称是笔记本文件名。
选项
--asset-type CleanRoomAssetAssetType
资产的类型。 支持的值:FOREIGN_TABLE、NOTEBOOK_FILE、TABLE、VIEW、VOLUME
--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 格式
日志格式类型,text 或 json。 默认值是 text。
--log-level 字符串
一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。
-o, --output 类型
命令输出类型为text或json。 默认值是 text。
-p, --profile 字符串
~/.databrickscfg 文件中用于运行命令的配置文件的名称。 如果未指定此标志,则如果存在,将使用名为 DEFAULT 的配置文件。
--progress-format 格式
显示进度日志的格式: default、 append、 inplace或 json
-t, --target 字符串
如适用,要使用的捆绑包目标