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.

    Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for type, especifique "type" para o identificador.