CREATE MODEL

Cria um novo modelo de aprendizado de máquina no esquema atual/especificado ou substitui um modelo existente.

Nota

Use a API Python Snowflake Model Registry para criar modelos do zero. Em SQL, você só pode criar modelos a partir de outros modelos.

Os modelos possuem versão. Todos os modelos devem ter pelo menos uma versão, e uma versão deve ser designada como padrão. Para adicionar uma versão a um modelo, use ALTER MODEL … ADD VERSION.

Algumas propriedades de um modelo podem ser modificadas (veja ALTER MODEL), e várias versões podem ser adicionadas.

Este comando também oferece suporte à seguinte variante:

  • CREATE MODEL … FROM internalStage (cria um modelo a partir de arquivos em um estágio externo)

Consulte também:

ALTER MODEL, ALTER MODEL … ADD VERSION, DROP MODEL, SHOW MODELS

Sintaxe

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

Sintaxe da variante

Esta variante é usada pela API Python Snowflake Model Registry. Não é possível criar modelos do zero em SQL.

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

Onde:

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

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

Parâmetros obrigatórios

name

Cadeia de caracteres que especifica o identificador (ou seja, nome) do novo modelo; deve ser único para o esquema no qual o modelo é criado.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

FROM MODEL source_model_name
Obrigatório se não estiver usando a variante internalStage FROM

Especifica o nome do modelo a partir do qual o novo modelo será criado.

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

Especifica o estágio interno que contém os arquivos do modelo. O layout necessário desses arquivos não está documentado atualmente.

Parâmetros opcionais

WITH VERSION version_name
Para uso com a variante FROM MODEL

Especifica o nome da versão a ser criada no novo modelo.

VERSION source_version_or_alias_name
Para uso com a variante FROM MODEL

Especifica o nome ou alias da versão a ser copiada do modelo de origem. Se não for especificado, usa a versão padrão do modelo de origem.

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio

Objeto

Notas

CREATE MODEL

Esquema

Implícito por USAGE no esquema

OWNERSHIP

Modelo

Uma função deve ser concedida ou herdar o privilégio OWNERSHIP no objeto para criar um objeto temporário com o mesmo nome do objeto que já existe no esquema.

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Linguagem: Português