Mostra uma lista de tabelas em um esquema, bem como alguns atributos da tabela.
Cada linha de saída é composta dos seguintes elementos: nome do banco de dados, nome do esquema, nome da tabela, tipo de tabela, ACL da tabela e comentários. Para obter mais informações sobre esses atributos, consulte SVV_ALL_TABLES.
Se mais de 10.000 tabelas resultarem do comando SHOW TABLES, será retornado um erro.
Permissões obrigatórias
Para visualizar uma tabela em um esquema do Amazon Redshift, o usuário atual deve atender a um dos seguintes critérios:
Ser um superusuário.
Ser o proprietário da tabela.
Ter recebido o privilégio USAGE no esquema principal e o privilégio SELECT na tabela ou ter recebido o privilégio SELECT em qualquer coluna da tabela.
Sintaxe
SHOW TABLES FROM SCHEMA database_name.schema_name [LIKE 'filter_pattern'] [LIMIT row_limit ]
Parâmetros
- database_name
-
O nome do banco de dados que contém as tabelas a serem listadas.
Para mostrar tabelas em um AWS Glue Data Catalog, especifique (
awsdatacatalog) como o nome do banco de dados e assegure que a configuração do sistemadata_catalog_auto_mountesteja definida comotrue. Para obter mais informações, consulte ALTER SYSTEM. - schema_name
-
O nome do esquema que contém as tabelas a serem listadas.
Para mostrar tabelas do AWS Glue Data Catalog, forneça o nome do banco de dados do AWS Glue como nome do esquema.
- filter_pattern
-
Uma expressão de caractere UTF-8 válida com o padrão para estabelecer correspondência com os nomes da tabela. A opção LIKE executa uma correspondência com distinção entre letras maiúsculas e minúsculas compatível com os seguintes metacaracteres de correspondência de padrões:
Metacaractere Descrição %Corresponde a qualquer sequência de zero ou mais caracteres. _Corresponde a qualquer caractere único. Se filter_pattern não contiver metacaracteres, o padrão representará somente a própria string. Nesse caso, LIKE age da mesma forma que o operador de igualdade.
- row_limit
-
O número máximo de linhas a serem retornadas. O row_limit pode ser de 0 a 10.000.
Exemplos
O exemplo a seguir mostra as tabelas no banco de dados do Amazon Redshift chamado dev que estão no esquema public.
SHOW TABLES FROM SCHEMA dev.public;
database_name | schema_name | table_name | table_type | table_acl | remarks
---------------+-------------+------------+------------+-----------+---------
dev | public | tb | TABLE | |
dev | public | tb2 | TABLE | |
dev | public | tb3 | TABLE | |
O exemplo a seguir mostra as tabelas no banco de dados do AWS Glue Data Catalog chamado awsdatacatalog que estão no esquema batman.
SHOW TABLES FROM SCHEMA awsdatacatalog.batman;
database_name | schema_name | table_name | table_type | table_acl | remarks
----------------+-------------+------------------+------------+-----------+---------
awsdatacatalog | batman | nation | EXTERNAL | |
awsdatacatalog | batman | part | EXTERNAL | |
awsdatacatalog | batman | partsupp | EXTERNAL | |
awsdatacatalog | batman | region | EXTERNAL | |
awsdatacatalog | batman | supplier | EXTERNAL | |
awsdatacatalog | batman | automount_nation | EXTERNAL | |
