CREATE MODEL

在当前/指定架构中创建新的机器学习模型，或替换现有模型。

备注

使用 Snowflake Model Registry Python API 从零开始创建模型。在 SQL 中，您只能从其他模型创建模型。

模型经过版本化。所有模型必须至少有一个版本，并且必须指定一个版本作为默认值。要将版本添加到模型，请使用 ALTER MODEL ...ADD VERSION。

可以修改模型的某些属性（请参阅 ALTER MODEL），也可以添加任意数量的版本。

此命令还支持以下变体：

  • CREATE MODEL ...FROM MODEL（从现有模型创建模型）

另请参阅：

ALTER MODEL、ALTER MODEL ...ADD VERSION、DROP MODEL、SHOW MODELS

语法

CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <name> FROM internalStage
Copy

其中：

internalStage ::=
    @[<namespace>.]<int_stage_name>[/<path>]
  | @[<namespace>.]%<table_name>[/<path>]
  | @~[/<path>]
Copy

有关其他内部暂存区的详细信息，请参阅 为本地文件选择内部暂存区。

变体语法

CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <name> [ WITH VERSION <version_name> ]
    FROM MODEL <source_model_name> [ VERSION <source_version_name> ]
Copy

必填参数

name

字符串，用于指定新模型的标识符（即名称），对于创建模型的架构必须是唯一的。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

FROM internalStage
如果不使用 FROM MODEL 变体，则为必填

指定包含模型文件的内部暂存区。现在没有记录这些文件所需的布局。

FROM MODEL source_model_name
如果使用 FROM MODEL 变体，则为必填

指定从中创建新模型的模型的名称。

可选参数

WITH VERSION version_name
用于 FROM MODEL 变体

指定要在新模型中创建的版本的名称。

VERSION source_version_name
用于 FROM MODEL 变体

指定要从源模型复制的版本的名称。如果未指定，则使用源模型中的默认版本。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

CREATE MODEL

架构

受架构 USAGE 影响

OWNERSHIP

模型

若要创建创建与架构中已存在的对象同名的临时对象，必须授予角色或使其继承对象上的 OWNERSHIP 权限。

请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

语言: 中文