Het SHOW TABLES statement geeft een lijst van het schema, tabelnaam, tabel type, eigenaar, en geschat aantal rijen voor de tabellen of views in een schema of database.
Terwijl een tabel of view wordt gedropt, zal SHOW TABLES het object met een (dropped) achtervoegsel opsommen.
Synopsis
Vereiste rechten
De SELECT rechten op een tabel zijn vereist om deze te kunnen weergeven met SHOW TABLES.
Parameters
| Parameter | Beschrijving |
|---|---|
database_name |
De naam van de database waarvoor tabellen moeten worden getoond. |
schema_name |
De naam van het schema waarvoor tabellen moeten worden getoond. |
Wanneer een database_name en schema_name worden weggelaten, worden de tabellen van het huidige schema in de huidige database getoond.
SHOW TABLES zal eerst proberen een schema met de opgegeven naam te vinden. Als dat niet lukt, wordt geprobeerd een database met die naam te vinden, en worden de tabellen van het public schema opgesomd. Zie Naamresolutie voor meer details.
Voorbeelden
Instelling
De volgende voorbeelden gebruiken MovR, een fictieve toepassing voor het delen van voertuigen, om CockroachDB SQL statements te demonstreren. Voor meer informatie over de MovR voorbeeld applicatie en dataset, zie MovR: A Global Vehicle-sharing App.
Om mee te volgen, start u cockroach demo om een tijdelijk, in-memory cluster te starten met de movr dataset voorgeladen:
$ cockroach demoToon tabellen in de huidige database
SHOW TABLES gebruikt het huidige schema public dat standaard is ingesteld in 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)Als alternatief kunt u binnen de ingebouwde SQL-shell gebruikmaken van het \dt shellcommando:
> \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)Toon tabellen in een ander schema
U kunt de tabellen in andere schema’s dan het huidige schema laten zien. U kunt ook het schema per tabel laten zien:
> SHOW TABLES FROM movr.information_schema;> SHOW TABLES FROM information_schema;Omdat movr de huidige database is, geven deze verklaringen dezelfde uitvoer:
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)Toon tabellen in een andere database
Je kunt ook tabellen uit een andere database tonen.
> SHOW TABLES FROM system.public;> SHOW TABLES FROM system;Omdat public het huidige schema is, geven deze verklaringen dezelfde uitvoer:
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)U kunt COMMENT ON gebruiken om commentaar aan een tabel toe te voegen.
> COMMENT ON TABLE users IS 'This table contains information about users.';Om de opmerkingen van een tabel te bekijken:
> SHOW TABLES FROM movr WITH COMMENT;iv
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)U kunt de opmerkingen bij een tabel ook bekijken met 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)Voor meer informatie, zie COMMENT ON.
De virtuele tabellen in de pg_cataloginformation_schema, en crdb_internal schema’s bevatten nuttig commentaar, vaak met links naar verdere documentatie.
Om virtuele tabellen met commentaar en documentatie links te bekijken, gebruikt u SHOW TABLES FROM <virtual schema> WITH COMMENT:
> SHOW TABLES FROM information_schema WITH COMMENT;