model-versions 命令组

model-versions Databricks CLI 中的命令组包含用于管理 Unity 目录中模型注册表中的模型版本的命令。 Unity 目录中的模型提供跨 Databricks 工作区集中的访问控制、审核、世系和 ML 模型的发现。 请参阅在 Unity Catalog 中管理模型生命周期。

databricks 模型版本删除

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

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

databricks model-versions delete FULL_NAME VERSION [flags]

论据

FULL_NAME

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

VERSION

    模型版本的整数版本号

选项

全局标志

例子

以下示例删除模型版本 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]

论据

FULL_NAME

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

VERSION

    模型版本的整数版本号

选项

--include-aliases

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

--include-browse

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

全局标志

例子

以下示例获取模型的版本 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]

论据

FULL_NAME

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

ALIAS

    别名的名称

选项

--include-aliases

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

全局标志

例子

以下示例演示了如何通过别名获得模型版本：

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]

论据

FULL_NAME

    用于列出模型版本的已注册模型的完整三级名称

选项

--include-browse

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

--max-results int

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

--page-token string

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

全局标志

例子

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

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]

论据

FULL_NAME

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

VERSION

    模型版本的整数版本号

选项

--comment string

    附加到模型版本的注释。

--json JSON

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

全局标志

例子

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

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

全局标志

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

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