SHOW MODELS¶

Lista os modelos de machine learning aos quais você tem privilégios de acesso.

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 VERSIONS IN MODEL

Sintaxe¶

SHOW MODELS [ LIKE '<pattern>' ]
            [ IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_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 DATABASE [ db_name ] | SCHEMA [ schema_name ]

Opcionalmente, especifica o escopo do comando, que determina se o comando lista modelos apenas no banco de dados ou esquema atual/especificado.

Se você especificar a palavra-chave ACCOUNT, então o comando recuperará os registros de todos os esquemas em todos os bancos de dados da conta atual.

Se você especificar a palavra-chave DATABASE, então:

Se você especificar um db_name, então o comando recupera registros para todos os esquemas do banco de dados especificado.
Se você não especificar um db_name, então:
- Se houver um banco de dados atual, então o comando recuperará os registros de todos os esquemas do banco de dados atual.
- Se não houver um banco de dados atual, então o comando recuperará registros para todos os bancos de dados e esquemas da conta.

Se você especificar a palavra-chave SCHEMA, então:

Se você especificar um nome de esquema qualificado (por exemplo, my_database.my_schema), então o comando recuperará registros para o banco de dados e esquema especificado.
Se você especificar um schema_name não qualificado, então:
- Se houver um banco de dados atual, então o comando recupera os registros para o esquema especificado no banco de dados atual.
- Se não houver um banco de dados atual, então o comando exibe o erro SQL compilation error: Object does not exist, or operation cannot be performed.
Se você não especificar um schema_name, então:
- Se houver um banco de dados atual, então:
  - Se houver um esquema atual, então o comando recupera registros para o esquema atual no banco de dados atual.
  - Se não houver um esquema atual, então o comando recupera os registros de todos os esquemas no banco de dados atual.
- Se não houver um banco de dados atual, então o comando recupera os registros de todos os bancos de dados e todos os esquemas da conta.

Padrão: depende se a sessão tem ou não um banco de dados em uso no momento:

Banco de dados: DATABASE é o padrão (ou seja, o comando retorna os modelos nos quais você tem privilégios para visualizar no banco de dados atual).
Sem banco de dados: o escopo da conta é o padrão (ou seja, o comando retorna os modelos que você tem privilégios para visualizar em sua conta).

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 o modelo foi criado.
nome	Nome do modelo.
database_name	Banco de dados no qual o modelo é armazenado.
schema_name	Esquema no qual o modelo é armazenado.
proprietário	Função proprietária do modelo.
comentário	Comentário para o modelo.
versões	Matriz JSON listando versões do modelo.
nome_da_versão_padrão	Versão do modelo utilizado quando se refere ao modelo sem versão.

Notas de uso¶

Os resultados são classificados por nome do banco de dados, nome do esquema e nome do modelo. Isso significa que os resultados de um banco de dados podem conter modelos de vários esquemas e podem quebrar a paginação. Para que a paginação funcione conforme esperado, você deve executar a instrução SHOW MODELS para um único esquema. Você pode usar o parâmetro IN SCHEMA schema_name para o comando SHOW MODELS. Alternativamente, você pode usar o esquema no contexto atual executando um USE SCHEMA schema_name antes de executar uma instrução SHOW TABLES.