SHOW TABLES

PDFRSS

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 la table, l’ACL de la table et des remarques. Pour obtenir plus d’informations sur ces attributs, consultez SVV_ALL_TABLES.

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.

• Soyez 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 ]

Paramètres

database_name

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

Pour afficher les tables dans un AWS Glue Data Catalog, spécifiez (awsdatacatalog) comme nom de base de données et assurez-vous que la configuration du système data_catalog_auto_mount est définie surtrue. Pour de plus amples informations, veuillez consulter ALTER SYSTEM.

nom_schéma

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

Pour afficher AWS Glue Data Catalog les tables, indiquez le nom AWS Glue de la base de données comme nom du schéma.

filter_pattern

Expression de caractères UTF-8 valide constituée d’un modèle à mettre en correspondance avec les noms de 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

L’exemple suivant montre les tables de la base de données Amazon Redshift nommée dev qui se trouvent dans le schéma 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      |           |

L'exemple suivant montre les tables de la AWS Glue Data Catalog base de données nommée awsdatacatalog qui figurent dans le schémabatman.

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