View a markdown version of this page

SHOW TABLES - Amazon Redshift
Autorisations requisesSyntaxeParametersExemples

Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie et des options de migration de Python, consultez le billet de blog qui a été publié le 30 juin 2025.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

SHOW TABLES

Affiche la liste des tables d’un schéma ainsi que certains attributs de table.

Chaque ligne de sortie comprend le nom de la base de données, le nom du schéma, le nom de la table, le type de table, l'ACL de la table, les remarques, le propriétaire de la table, l'heure de la dernière modification, l'heure de la dernière modification, dist_style et le sous-type de la table. Pour obtenir plus d’informations sur ces attributs, consultez SVV_ALL_TABLES.

Les horodatages des modifications et des altérations peuvent prendre du retard par rapport aux mises à jour du tableau à un intervalle fixe d'environ 5 minutes.

Si le résultat de la commande SHOW TABLES compte plus de 10 000 tables, une erreur est renvoyée.

Autorisations requises

Pour afficher une table dans un schéma Amazon Redshift, l’utilisateur actuel doit satisfaire à l’un des critères suivants :

  • Être un super-utilisateur.

  • Être le propriétaire de la table.

  • Le privilège USAGE a été accordé sur le schéma parent et le privilège SELECT sur la table ou le privilège SELECT sur n’importe quelle colonne de la table.

Syntaxe

SHOW TABLES FROM SCHEMA database_name.schema_name [LIKE 'filter_pattern'] [LIMIT row_limit ]

Parameters

database_name

Nom de la base de données qui contient les tables à répertorier.

Pour afficher des tableaux dans un AWS Glue Data Catalog, spécifiez (awsdatacatalog) comme nom de base de données, et assurez-vous de la configuration du système data_catalog_auto_mount est réglé sur true. Pour plus d’informations, consultez ALTER SYSTEM.

nom_schéma

Nom du schéma qui contient les tables à répertorier.

À montrer AWS Glue Data Catalog tableaux, fournissez les AWS Glue nom de la base de données comme nom du schéma.

filter_pattern

Un valide UTF-8 expression de caractère avec un modèle correspondant aux noms des tables. L’option LIKE effectue une mise en correspondance sensible à la casse qui prend en charge les métacaractères de mise en correspondance de modèle suivants :

Métacaractère Description
% Met en correspondance une séquence de zéro ou plusieurs caractères.
_ Met en correspondance un seul caractère.

Si filter_pattern ne contient pas de métacaractères, le modèle représente uniquement la chaîne elle-même ; dans ce cas, LIKE a la même fonction que l’opérateur d’égalité.

row_limit

Nombre maximal de lignes à renvoyer. La valeur de row_limit peut aller de 0 à 10 000.

Exemples

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

Les vues matérialisées d'Iceberg apparaissent dans la sortie SHOW TABLES avec table_type = 'EXTERNAL TABLE' et table_subtype = 'ICEBERG MATERIALIZED VIEW'. Cela les distingue des vues matérialisées standard (RMS), qui ont table_type = 'VIEW' et table_subtype = 'MATERIALIZED VIEW'.

L'exemple suivant répertorie les tables dans un AWS Glue base de données, où les vues matérialisées d'Iceberg peuvent être identifiées par table_subtype:

SHOW TABLES FROM SCHEMA awsdatacatalog.mydb LIKE '%';