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:
Sintaxe¶
SHOW VERSIONS [ LIKE '<pattern>' ] IN MODEL <model_name>
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
ouschema_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 ( |
user_data |
Objeto JSON da seção |
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.