SHOW VERSIONS IN MODEL¶

Lista as versões em um modelo de machine learning. Os modelos podem ter diversas versões, uma das quais pode ser designada como padrão (consulte ALTER MODEL).

A saída retorna metadados e propriedades da tabela, ordenados lexicograficamente por banco de dados, esquema e nome do modelo (consulte Saída neste tópico para descrições das colunas de saída). Isso é importante se você deseja filtrar os resultados usando os filtros fornecidos.

Consulte também:: CREATE MODEL , DROP MODEL , ALTER MODEL, SHOW MODELS

Sintaxe¶

SHOW VERSIONS [ LIKE '<pattern>' ] IN MODEL <model_name>

Copy

Parâmetros¶

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

IN MODEL model_name

Especifica o identificador do modelo que contém as versões a serem listadas. 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 (por exemplo, "My Object").

Se o identificador do modelo não estiver totalmente qualificado (na forma de db_name.schema_name.model_name ou schema_name.model_name), o comando procura o modelo no esquema atual para a sessão.

Saída¶

O comando de saída fornece propriedades de tabela e metadados nas seguintes colunas:

Coluna	Descrição
created_on	Data e hora em que a versão do modelo foi criada.
name	Nome da versão.
aliases	Aliases da versão do modelo, se houver, incluindo qualquer um que você tenha atribuído usando ALTER MODEL e quaisquer aliases do sistema (DEFAULT, FIRST ou LAST) que se apliquem. Se uma versão do modelo não tiver aliases, esta coluna conterá uma ARRAY vazia ([]).
database_name	Banco de dados no qual a versão está armazenada.
schema_name	Esquema no qual a versão está armazenada.
model_name	Nome do modelo ao qual esta versão pertence.
is_default_version	Valor booliano que indica se esta versão é a versão padrão do modelo.
functions	Matriz JSON dos nomes das funções disponíveis nesta versão.
metadata	Objeto JSON contendo metadados como pares chave-valor (`{}` se nenhum metadado for especificado).
user_data	Objeto JSON da seção `user_data` do manifesto de definição do modelo (`{}` se nenhum dado do usuário for especificado).

Notas de uso¶

O comando não precisa de um warehouse em funcionamento para ser executado.
O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.
O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.

Para pós-processar a saída deste comando, você pode usar o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

Por exemplo, você pode usar o operador de canal ou a função RESULT_SCAN para selecionar colunas específicas da saída do comando SHOW ou filtrar as linhas.

Quando você fizer referência a colunas de saída, use identificadores entre aspas duplas para os nomes das colunas. Por exemplo, para selecionar a coluna de saída type, especifique SELECT "type".

Você deve usar identificadores entre aspas duplas porque os nomes das colunas de saída para os comandos SHOW estão em minúsculas. As aspas duplas garantem que os nomes das colunas na lista SELECT ou na cláusula WHERE correspondam aos nomes das colunas na saída do comando SHOW que foi verificada.