SHOW <objetos>

Lista os objetos existentes para o tipo de objeto especificado. A saída inclui metadados para os objetos, inclusive:

  • Propriedades comuns (nome, carimbo de data/hora, função de proprietário, comentário etc.)

  • Propriedades específicas do objeto

Consulte também:

CREATE <objeto> , DESCRIBE <objeto>

Sintaxe

SHOW <object_type_plural> [ LIKE '<pattern>' ] [ IN <scope_object_type> [ <scope_object_name> ] ]
Copy

Para sintaxes, notas de uso e exemplos específicos, consulte:

Operações de conta

Operações de sessão/usuário:

Objetos de conta:

Objetos de banco de dados:

Classes:

Notas de uso geral

  • Comandos SHOW não exigem um warehouse em funcionamento para serem executados.

  • Comandos SHOW só devolvem objetos para os quais a função atual tenha recebido os privilégios de acesso necessários. Por exemplo:

    • A saída SHOW DATABASES inclui os bancos de dados para os quais a função tem o privilégio OWNERSHIP ou USAGE.

    • A saída SHOW SCHEMAS inclui os esquemas para os quais a função do usuário tem o privilégio OWNERSHIP ou USAGE.

    • A saída SHOW TABLES inclui as tabelas para as quais a função do usuário tem qualquer privilégio. A função também deve ter o privilégio USAGE sobre o banco de dados e o esquema principais.

    • 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.

  • A saída da maioria dos comandos SHOW pode ser controlada usando as seguintes cláusulas:

    • A cláusula opcional LIKE pode ser usada para filtrar a lista de objetos devolvidos pelo nome.

    • Os tipos de objeto de banco de dados fornecem uma cláusula IN adicional e opcional, que pode ser usada para definir o escopo do comando para um esquema ou banco de dados específico, ou em toda a conta.

    Nota

    Usar comandos SHOW sem uma cláusula IN em um contexto de banco de dados pode resultar em menos resultados do que o esperado.

    Objetos com o mesmo nome só serão exibidos uma vez se nenhuma cláusula IN for utilizada. Por exemplo, se você tiver a tabela t1 em schema1 e t1 em schema2 e ambas estiverem no escopo do contexto do banco de dados que você especificou (ou seja, o banco de dados que você selecionou é o pai de schema1 e schema2), então SHOW TABLES exibirá apenas uma das tabelas t1.

  • As colunas que começam com o prefixo is_ retornam Y (sim) ou N (não).

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna um máximo de 10 mil registros para o tipo de objeto especificado, como ditado pelos privilégios de acesso para a função usada para executar o comando; quaisquer registros acima do limite 10 mil não são retornados, mesmo com um filtro aplicado.

    Para visualizar resultados para os quais existem mais de 10.000 registros, consulte a visualização correspondente (se houver) em Snowflake Information Schema.

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.