W psql \l wypisuje bazy danych, \c dbname łączy z jedną z nich, a \dt wypisuje tabele bieżącej bazy. Z poziomu SQL albo dowolnego innego klienta odpytaj katalogi: pg_database dla baz danych i information_schema.tables dla tabel.
Zapytanie zwraca dwie tabele jako BASE TABLE i widok jako VIEW, wszystkie w schemacie public. Filtr WHERE ukrywa katalogi systemowe, które dodałyby setki wierszy. Dopisz AND table_type = 'BASE TABLE', żeby pominąć widoki.
Polecenia psql dla baz danych i tabel
To metapolecenia psql. psql zamienia każde z nich w zapytanie do katalogu, więc nie działają w innych klientach ani w kodzie aplikacji.
| Polecenie | Pokazuje |
|---|---|
\l | Bazy danych (\l+ dodaje rozmiary) |
\c shop | Łączy z bazą shop |
\conninfo | Bazę, użytkownika i hosta, na których jesteś |
\dn | Schematy |
\dt | Tabele w schematach z twojego search_path |
\dt sales.* | Tabele w schemacie sales |
\dt *.* | Tabele we wszystkich schematach, także systemowych |
\dt+ | Tabele z rozmiarem i opisem |
\dv, \di, \ds | Widoki, indeksy, sekwencje |
\d orders | Kolumny, indeksy i ograniczenia orders |
\d+ orders | To samo plus przechowywanie i komentarze |
\du | Role |
Z powłoki psql -l wypisuje listę baz i kończy działanie, a -c uruchamia jedno polecenie:
psql -l
psql -d shop -c '\dt'
Uruchom psql z -E, żeby wypisywał SQL stojący za każdym metapoleceniem. To szybki sposób na poznanie tabel katalogu.
Lista baz danych w SQL
Każda baza na serwerze to wiersz w pg_database. template0 i template1 to szablony, które kopiuje CREATE DATABASE, więc je odfiltruj:
Na tej stronie każde uruchomienie dostaje świeżą bazę, której nazwa zaczyna się od lesson_. Wynik pokazuje ją i postgres, domyślną bazę, którą tworzy każdy serwer. SELECT current_database() zwraca bazę, z którą jesteś połączony.
Opis kolumn tabeli
W psql \d orders opisuje tabelę. W SQL information_schema.columns ma jeden wiersz na kolumnę:
id pokazuje NO w is_nullable, bo klucz główny jest zawsze NOT NULL. Jego column_default jest pusty: kolumna identity bierze wartości z sekwencji, a nie z wartości domyślnej.
Bezpośrednie zapytania do pg_catalog
information_schema to widok ze standardu SQL i pokazuje tylko obiekty, do których masz jakieś uprawnienia. Katalogi specyficzne dla PostgreSQL w pg_catalog zawierają więcej, na przykład definicje indeksów:
Zapytanie wypisuje trzy indeksy: orders_email_key z UNIQUE, orders_pkey z klucza głównego i utworzony przez ciebie indeks częściowy. Każdy ma polecenie CREATE INDEX, które by go odbudowało. pg_tables wypisuje tylko tabele; pg_views i pg_matviews obejmują widoki i widoki zmaterializowane.
Liczba wierszy w każdej tabeli
Katalogi nie przechowują dokładnych liczb wierszy. pg_class.reltuples zawiera szacunek planera, który aktualizują VACUUM i ANALYZE. Jest wystarczająco dokładny, żeby wyłapać duże tabele, a -1 oznacza, że tabela nigdy nie była analizowana:
SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;
Dla dokładnej liczby uruchom SELECT count(*) FROM orders, które czyta całą tabelę. Tabele katalogu są opisane w części System Catalogs dokumentacji PostgreSQL.
Najczęściej zadawane pytania
Czy PostgreSQL ma SHOW TABLES albo SHOW DATABASES?
Nie, to polecenia MySQL. W PostgreSQL SHOW odczytuje ustawienie serwera, więc SHOW TABLES kończy się błędem "unrecognized configuration parameter". Użyj \dt i \l w psql albo odpytaj information_schema.tables i pg_database.
Dlaczego \dt pokazuje "Did not find any relations"?
Albo jesteś połączony z inną bazą niż ta, w której są tabele, albo tabele leżą w schemacie, którego nie ma w twoim search_path. Sprawdź \conninfo, a potem spróbuj \dt *.* albo \dt schema_name.*.
Jak przełączyć bazę danych w PostgreSQL?
Połączenie należy do jednej bazy, a SQL nie ma polecenia USE. W psql uruchom \c other_db, co otwiera nowe połączenie; z powłoki uruchom psql -d other_db.
Jak sprawdzić rozmiar tabel w PostgreSQL?
W psql \dt+ dodaje kolumnę z rozmiarem. W SQL pg_size_pretty(pg_total_relation_size('orders')) podaje rozmiar tabeli razem z indeksami i danymi TOAST.