L’instruction SHOW TABLES liste le schéma, le nom de la table, le type de table, le propriétaire et le nombre de lignes estimé pour les tables ou les vues dans un schéma ou une base de données.
Alors qu’une table ou une vue est en cours d’abandon, SHOW TABLES listera l’objet avec un (dropped) suffixe.
Synopsis
Privilèges requis
Le privilège SELECT sur une table est nécessaire pour la répertorier avec SHOW TABLES.
Paramètres
| Paramètre | Description |
|---|---|
database_name |
Le nom de la base de données pour laquelle afficher les tables. |
schema_name |
Le nom du schéma pour lequel afficher les tables. |
Lorsqu’une database_name et schema_name sont omises, les tables du schéma actuel dans la base de données actuelle sont listées.
SHOW TABLES tentera d’abord de trouver un schéma avec le nom spécifié. Si cela échoue, il essaiera de trouver une base de données avec ce nom à la place, et de lister les tables de son public schéma. Pour plus de détails, voir Résolution de noms.
Exemples
Mise en place
Les exemples suivants utilisent MovR, une application fictive de partage de véhicules, pour démontrer les instructions SQL de CockroachDB. Pour plus d’informations sur l’application d’exemple et le jeu de données MovR, voir MovR : une application mondiale de partage de véhicules.
Pour suivre, exécutez cockroach demo pour démarrer un cluster temporaire, en mémoire, avec le movr dataset préchargé :
$ cockroach demoVoir les tables de la base de données actuelle
.
SHOW TABLES utilise le schéma actuel public défini par défaut dans search_path :
> SHOW TABLES; schema_name | table_name | type | estimated_row_count--------------+----------------------------+-------+---------------------- public | promo_codes | table | 1000 public | rides | table | 500 public | user_promo_codes | table | 0 public | users | table | 50 public | vehicle_location_histories | table | 1000 public | vehicles | table | 15(6 rows)Au lieu de cela, dans le shell SQL intégré, vous pouvez utiliser la commande \dt :
> \dt schema_name | table_name | type | estimated_row_count--------------+----------------------------+-------+---------------------- public | promo_codes | table | 1000 public | rides | table | 500 public | user_promo_codes | table | 0 public | users | table | 50 public | vehicle_location_histories | table | 1000 public | vehicles | table | 15(6 rows)Afficher les tables dans un schéma différent
Vous pouvez afficher les tables dans des schémas autres que le schéma actuel. Vous pouvez également afficher le schéma par table :
> SHOW TABLES FROM movr.information_schema;> SHOW TABLES FROM information_schema;Parce que movr est la base de données actuelle, ces instructions renvoient le même résultat :
schema_name | table_name | type | estimated_row_count---------------------+-----------------------------------+-------+---------------------- information_schema | administrable_role_authorizations | table | NULL information_schema | applicable_roles | table | NULL information_schema | check_constraints | table | NULL information_schema | column_privileges | table | NULL ...(23 rows)Montrer les tables dans une autre base de données
Vous pouvez également montrer les tables d’une autre base de données.
> SHOW TABLES FROM system.public;.
> SHOW TABLES FROM system;Parce que public est le schéma actuel, ces instructions renvoient le même résultat :
schema_name | table_name | type | estimated_row_count--------------+---------------------------------+-------+---------------------- public | comments | table | NULL public | descriptor | table | NULL public | eventlog | table | NULL public | jobs | table | NULL ...(29 rows)Vous pouvez utiliser COMMENT ON pour ajouter des commentaires sur un tableau.
> COMMENT ON TABLE users IS 'This table contains information about users.';Pour visualiser les commentaires d’un tableau :
> SHOW TABLES FROM movr WITH COMMENT; schema_name | table_name | type | estimated_row_count | comment--------------+----------------------------+-------+---------------------+----------------------------------------------- public | promo_codes | table | 1000 | public | rides | table | 500 | public | user_promo_codes | table | 0 | public | users | table | 50 | This table contains information about users. public | vehicle_location_histories | table | 1000 | public | vehicles | table | 15 |(6 rows)Vous pouvez également afficher les commentaires d’un tableau avec SHOW CREATE :
> SHOW CREATE TABLE users; table_name | create_statement-------------+--------------------------------------------------------------------------- users | CREATE TABLE users ( | id UUID NOT NULL, | city VARCHAR NOT NULL, | name VARCHAR NULL, | address VARCHAR NULL, | credit_card VARCHAR NULL, | CONSTRAINT "primary" PRIMARY KEY (city ASC, id ASC), | FAMILY "primary" (id, city, name, address, credit_card) | ); | COMMENT ON TABLE users IS 'This table contains information about users.'(1 row)Pour plus d’informations, voir COMMENT ON.
Les tables virtuelles des schémas pg_cataloginformation_schema et crdb_internal contiennent des commentaires utiles, souvent accompagnés de liens vers une documentation complémentaire.
Pour afficher des tableaux virtuels avec des commentaires et des liens de documentation, utilisez SHOW TABLES FROM <virtual schema> WITH COMMENT:
> SHOW TABLES FROM information_schema WITH COMMENT;Voir aussi
.