model-versions 命令组

The model-versions command group within the Databricks CLI contains commands to manage model versions in the model registry in Unity Catalog. Unity 目录中的模型提供跨 Databricks 工作区集中的访问控制、审核、世系和 ML 模型的发现。 请参阅在 Unity Catalog 中管理模型生命周期。

databricks 模型版本删除

从指定的注册模型中删除模型版本。 还将删除分配给模型版本的任何别名。

调用方必须是元存储管理员或父注册模型的所有者。 对于后一种情况，调用方还必须是所有者，或者对 USE_CATALOG 父目录和 USE_SCHEMA 父架构具有特权。

databricks model-versions delete FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    模型版本的三级（完全限定）名称

VERSION

    模型版本的整数版本号

选项

Global flags

Examples

以下示例删除模型版本 1：

databricks model-versions delete main.my_schema.my_model 1

databricks 模型版本获取

获取模型版本。

调用方必须是元存储管理员或父注册模型的所有者（或具有 EXECUTE 权限）。 对于后一种情况，调用方还必须是所有者，或者对 USE_CATALOG 父目录和 USE_SCHEMA 父架构具有特权。

databricks model-versions get FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    模型版本的三级（完全限定）名称

VERSION

    模型版本的整数版本号

选项

--include-aliases

    是否在响应中包含与模型版本关联的别名。

--include-browse

    是否在主体只能访问其选择性元数据的响应中包含模型版本。

Global flags

Examples

以下示例获取模型的版本 1：

databricks model-versions get main.my_schema.my_model 1

以下示例获取包含别名的模型版本 1：

databricks model-versions get main.my_schema.my_model 1 --include-aliases

databricks 模型版本 get-by-alias

按别名获取模型版本。

调用方必须是已注册模型的元存储管理员或所有者（或拥有 EXECUTE 该权限）。 对于后一种情况，调用方还必须是所有者，或者对 USE_CATALOG 父目录和 USE_SCHEMA 父架构具有特权。

databricks model-versions get-by-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    已注册模型的三级（完全限定）名称

ALIAS

    别名的名称

选项

--include-aliases

    是否在响应中包含与模型版本关联的别名。

Global flags

Examples

以下示例按别名获取模型版本：

databricks model-versions get-by-alias main.my_schema.my_model production

以下示例按包含别名的别名获取模型版本：

databricks model-versions get-by-alias main.my_schema.my_model production --include-aliases

databricks 模型版本列表

列出模型版本。 可以在特定架构下列出模型版本，也可以列出当前元存储中的所有模型版本。

返回的模型根据呼叫用户的权限进行筛选。 例如，元存储管理员能够列出所有模型版本。 常规用户必须是所有者，或者具有 EXECUTE 父注册模型的权限才能在响应中接收模型版本。 对于后一种情况，调用方还必须是所有者，或者对 USE_CATALOG 父目录和 USE_SCHEMA 父架构具有特权。

不能保证响应中元素的特定排序。 响应中的元素不包含任何别名或标记。

databricks model-versions list FULL_NAME [flags]

Arguments

FULL_NAME

    要在其中列出模型版本的已注册模型的完整三级名称

选项

--include-browse

    是否在主体只能访问其选择性元数据的响应中包含模型版本。

--max-results int

    要返回的最大模型版本数。

--page-token string

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

Global flags

Examples

以下示例列出已注册模型的所有模型版本：

databricks model-versions list main.my_schema.my_model

以下示例列出具有分页的模型版本：

databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token

databricks 模型版本更新

更新指定的模型版本。

调用方必须是元存储管理员或父注册模型的所有者。 对于后一种情况，调用方还必须是所有者，或者对 USE_CATALOG 父目录和 USE_SCHEMA 父架构具有特权。

目前只能更新模型版本的注释。

databricks model-versions update FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    模型版本的三级（完全限定）名称

VERSION

    模型版本的整数版本号

选项

--comment string

    附加到模型版本的注释。

--json JSON

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

Global flags

Examples

以下示例更新模型版本注释：

databricks model-versions update main.my_schema.my_model 1 --comment "Updated model with improved accuracy"

以下示例使用 JSON 文件更新模型版本：

databricks model-versions update main.my_schema.my_model 1 --json @model-version-update.json

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

    显示进度日志的格式： default、 append、 inplace或 json

-t, --target 字符串

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