SHOW TABLES - Amazon Redshift
Permissões obrigatóriasSintaxeParâmetrosExemplos

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

SHOW TABLES

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, comentários, proprietário da tabela, hora da última alteração, hora da última modificação, dist_style e subtipo da tabela. Para obter mais informações sobre esses atributos, consulte SVV_ALL_TABLES.

Os carimbos de data/hora de modificação e alteração podem ficar atrasados em relação às atualizações da tabela em aproximadamente 20 minutos.

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 sistema data_catalog_auto_mount esteja definida como true. 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

SHOW TABLES FROM SCHEMA s1;

 database_name | schema_name |    table_name     | table_type |              table_acl              | remarks | owner |     last_altered_time      |     last_modified_time     | dist_style |   table_subtype   
---------------+-------------+-------------------+------------+-------------------------------------+---------+-------+----------------------------+----------------------------+------------+-------------------
 dev           | s1          | late_binding_view | VIEW       | alice=arwdRxtDPA/alice~bob=d/alice  |         | alice |                            |                            |            | LATE BINDING VIEW
 dev           | s1          | manual_mv         | VIEW       | alice=arwdRxtDPA/alice~bob=P/alice  |         | alice |                            |                            |            | MATERIALIZED VIEW
 dev           | s1          | regular_view      | VIEW       | alice=arwdRxtDPA/alice~bob=r/alice  |         | alice |                            |                            |            | REGULAR VIEW
 dev           | s1          | test_table        | TABLE      | alice=arwdRxtDPA/alice~bob=rw/alice |         | alice | 2025-11-18 15:52:00.010452 | 2025-11-18 15:44:34.856073 | AUTO (ALL) | REGULAR TABLE

SHOW TABLES FROM SCHEMA dev.s1 LIKE '%view' LIMIT 1;

 database_name | schema_name |    table_name     | table_type |              table_acl               | remarks | owner | last_altered_time | last_modified_time | dist_style |   table_subtype   
---------------+-------------+-------------------+------------+--------------------------------------+---------+-------+-------------------+--------------------+------------+-------------------
 dev           | s1          | late_binding_view | VIEW       | {alice=arwdRxtDPA/alice,bob=d/alice} |         | alice |                   |                    |            | LATE BINDING VIEW