View a markdown version of this page

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

O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. 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 um intervalo fixo de aproximadamente 5 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