Zdanie SHOW TABLES zawiera listę schematu, nazwę tabeli, typ tabeli, właściciela oraz szacowaną liczbę wierszy dla tabel lub widoków w schemacie lub bazie danych.
Podczas usuwania tabeli lub widoku, SHOW TABLES wyświetli listę obiektów z przyrostkiem (dropped).
Synopsis
Wymagane uprawnienia
Uprawnienie SELECT na tabeli jest wymagane, aby wyświetlić jej listę z SHOW TABLES.
Parametry
| Parametr | Opis |
|---|---|
database_name |
Nazwa bazy danych, dla której mają zostać wyświetlone tabele. |
schema_name |
Nazwa schematu, dla którego chcesz wyświetlić tabele. |
Gdy database_name i schema_name zostaną pominięte, wyświetlone zostaną tabele aktualnego schematu w bieżącej bazie danych.
SHOW TABLES W pierwszej kolejności zostanie podjęta próba znalezienia schematu o podanej nazwie. Jeśli to się nie powiedzie, spróbuje znaleźć bazę danych o tej nazwie i wyświetli tabele z jej public schematu. Aby uzyskać więcej szczegółów, zobacz Rozdzielanie nazw.
Przykłady
Ustawienie
Następujące przykłady używają MovR, fikcyjnej aplikacji do współdzielenia pojazdów, aby zademonstrować polecenia SQL CockroachDB. Więcej informacji na temat przykładowej aplikacji MovR i zbioru danych znajdziesz w MovR: A Global Vehicle-sharing App.
Aby śledzić rozwój wydarzeń, uruchom cockroach demo aby uruchomić tymczasowy klaster in-memory z załadowanym zbiorem danych movr:
$ cockroach demoPokazanie tabel w bieżącej bazie danych
.
SHOW TABLES wykorzystuje aktualny schemat public ustawiony domyślnie w 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)Alternatywnie, w ramach wbudowanej powłoki SQL, można użyć polecenia powłoki \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)Pokaż tabele w innym schemacie
Możesz pokazać tabele w schematach innych niż aktualny schemat. Możesz także pokazać schemat według tabel:
> SHOW TABLES FROM movr.information_schema;> SHOW TABLES FROM information_schema;Ponieważ movr jest bieżącą bazą danych, te instrukcje zwracają te same dane wyjściowe:
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)Pokaż tabele w innej bazie danych
Możesz również pokazać tabele z innej bazy danych.
> SHOW TABLES FROM system.public;> SHOW TABLES FROM system;Bez względu na to, że public jest bieżącym schematem, te instrukcje zwracają te same dane wyjściowe:
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)Możesz użyć COMMENT ON aby dodać komentarze do tabeli.
> COMMENT ON TABLE users IS 'This table contains information about users.';Aby wyświetlić komentarze do tabeli:
> 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)Możesz również wyświetlić komentarze do tabeli za pomocą 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)Więcej informacji można znaleźć w COMMENT ON.
Tablice wirtualne w schematach pg_cataloginformation_schema i crdb_internal zawierają przydatne komentarze, często z linkami do dalszej dokumentacji.
Aby wyświetlić wirtualne tabele z komentarzami i linkami do dokumentacji, użyj SHOW TABLES FROM <virtual schema> WITH COMMENT:
> SHOW TABLES FROM information_schema WITH COMMENT;Zobacz także
.