ALTER MODEL … ADD VERSION

Adiciona uma nova versão a um modelo existente a partir de uma versão de modelo existente. Versões são o código do modelo real que contém métodos que podem ser chamados para executar inferências e outras funções.

Nota

Use a API de Python do Registro de modelo Snowflake para criar versões de modelos do zero. Em SQL, você só pode criar versões de modelo a partir de versões de modelo existentes.

Algumas propriedades da versão podem ser modificadas (consulte ALTER MODEL … MODIFY VERSION), mas a implementação real do modelo contida em uma versão é imutável.

Este comando também oferece suporte à seguinte variante:

  • ALTER MODEL .. ADD VERSION … FROM internalStage (cria uma versão do modelo a partir de um estágio interno)

Consulte também:

ALTER MODEL … MODIFY VERSION, ALTER MODEL … DROP VERSION

Sintaxe

ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name>
  FROM MODEL <source_model_name> [ VERSION <source_version_name> ]

Sintaxe da variante

Esta variante é usada pela API Python Snowflake Model Registry. Não é possível criar versões de modelo do zero no SQL.

ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name> FROM internalStage

Onde:

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

Para obter detalhes adicionais do estágio interno, consulte Escolha de um estágio interno para os arquivos locais.

Parâmetros

name

Especifica o identificador do modelo. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, o identificador inteiro deverá ser colocado entre aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas. Para obter informações sobre a sintaxe do identificador, consulte Requisitos para identificadores.

ADD VERSION version_name

Especifica o identificador da versão, que deve ser exclusivo no modelo. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, o identificador inteiro deverá ser colocado entre aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas. Para obter informações sobre a sintaxe do identificador, consulte Requisitos para identificadores.

FROM MODEL source_model_name [ VERSION source_version_or_alias_name ]
Obrigatório se não estiver usando a variante internalStage FROM

Especifica o nome do modelo do qual a versão será obtida.

Para obter uma versão específica desse modelo, especifique a cláusula VERSION source_version_or_alias_name. Se você omitir esta cláusula, o comando obterá a versão padrão do modelo de origem.

FROM internalStage
Obrigatório se estiver usando a variante internalStage FROM

Especifica o estágio interno que contém os arquivos da versão.