CREATE MODEL¶
Cria um novo modelo de aprendizado de máquina no esquema atual/especificado ou substitui um modelo existente. Este comando é fornecido para uso pela API de Python do registro de modelo do Snowpark e não se destina a permitir a criação de modelos usando SQL.
Os modelos possuem versão. Todos os modelos devem ter pelo menos uma versão, e uma versão pode 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 (consulte ALTER MODEL) e qualquer número de versões pode ser adicionado, mas o objeto do modelo em si é imutável.
- Consulte também:
ALTER MODEL, ALTER MODEL … ADD VERSION, DROP MODEL , SHOW MODELS
Sintaxe¶
CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <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
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.
internalStage
Especifica o estágio interno que contém os arquivos do modelo. O layout necessário desses arquivos não está documentado atualmente.
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.