In psql listet \l die Datenbanken auf, \c dbname verbindet dich mit einer, und \dt zeigt die Tabellen der aktuellen Datenbank. Per SQL oder aus jedem anderen Client fragst du die Kataloge ab: pg_database für Datenbanken und information_schema.tables für Tabellen.
Die Abfrage liefert die beiden Tabellen als BASE TABLE und die View als VIEW, alle im Schema public. Der WHERE Filter blendet die Systemkataloge aus, die sonst Hunderte Zeilen beisteuern würden. Ergänze AND table_type = 'BASE TABLE', um Views wegzulassen.
psql Befehle für Datenbanken und Tabellen
Das sind Meta-Befehle von psql. psql macht aus jedem eine Katalogabfrage, sie funktionieren also nicht in anderen Clients oder im Anwendungscode.
| Befehl | Zeigt |
|---|---|
\l | Datenbanken (\l+ ergänzt die Größen) |
\c shop | Verbindet mit der Datenbank shop |
\conninfo | Die Datenbank, den Benutzer und den Host, auf dem du bist |
\dn | Schemas |
\dt | Tabellen in den Schemas deines search_path |
\dt sales.* | Tabellen im Schema sales |
\dt *.* | Tabellen in allen Schemas, auch den System-Schemas |
\dt+ | Tabellen mit Größe und Beschreibung |
\dv, \di, \ds | Views, Indizes, Sequenzen |
\d orders | Spalten, Indizes und Constraints von orders |
\d+ orders | Dasselbe plus Speicher und Kommentare |
\du | Rollen |
In der Shell gibt psql -l die Liste der Datenbanken aus und beendet sich, und -c führt einen einzelnen Befehl aus:
psql -l
psql -d shop -c '\dt'
Starte psql mit -E, um das SQL hinter jedem Meta-Befehl auszugeben. So lernst du die Katalogtabellen schnell kennen.
Datenbanken per SQL auflisten
Jede Datenbank auf dem Server ist eine Zeile in pg_database. template0 und template1 sind die Vorlagen, die CREATE DATABASE kopiert, also filterst du sie heraus:
Auf dieser Seite bekommt jeder Lauf eine frische Datenbank, deren Name mit lesson_ beginnt. Das Ergebnis zeigt sie und postgres, die Standarddatenbank, die jeder Server anlegt. SELECT current_database() liefert die, mit der du verbunden bist.
Die Spalten einer Tabelle beschreiben
In psql beschreibt \d orders die Tabelle. In SQL enthält information_schema.columns eine Zeile pro Spalte:
id zeigt unter is_nullable den Wert NO, weil ein Primärschlüssel immer NOT NULL ist. Sein column_default ist leer: Eine Identity-Spalte bezieht ihre Werte aus einer Sequenz, nicht aus einem Default.
pg_catalog direkt abfragen
information_schema ist die Sicht des SQL-Standards und zeigt nur Objekte, auf die du irgendein Recht hast. Die PostgreSQL-eigenen Kataloge in pg_catalog enthalten mehr, etwa Index-Definitionen:
Die Abfrage listet drei Indizes auf: orders_email_key aus UNIQUE, orders_pkey aus dem Primärschlüssel und den partiellen, den du angelegt hast. Zu jedem gibt es die CREATE INDEX Anweisung, die ihn neu bauen würde. pg_tables listet nur Tabellen auf; pg_views und pg_matviews decken Views und Materialized Views ab.
Die Zeilen jeder Tabelle zählen
Die Kataloge speichern keine exakten Zeilenzahlen. pg_class.reltuples enthält die Schätzung des Planers, die VACUUM und ANALYZE aktualisieren. Sie ist genau genug, um die großen Tabellen zu erkennen, und -1 bedeutet, dass die Tabelle nie analysiert wurde:
SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;
Für eine exakte Zahl führst du SELECT count(*) FROM orders aus, das die ganze Tabelle liest. Die Katalogtabellen sind unter System Catalogs im PostgreSQL Handbuch dokumentiert.
Häufig gestellte Fragen
Gibt es in PostgreSQL SHOW TABLES oder SHOW DATABASES?
Nein, das sind Befehle aus MySQL. In PostgreSQL liest SHOW eine Servereinstellung, SHOW TABLES scheitert also mit "unrecognized configuration parameter". Nimm \dt und \l in psql oder frag information_schema.tables und pg_database ab.
Warum meldet \dt "Did not find any relations"?
Entweder bist du mit einer anderen Datenbank verbunden als der, in der die Tabellen liegen, oder die Tabellen stehen in einem Schema, das nicht in deinem search_path ist. Prüf \conninfo und versuch dann \dt *.* oder \dt schema_name.*.
Wie wechsle ich in PostgreSQL die Datenbank?
Eine Verbindung gehört zu genau einer Datenbank, und SQL kennt keine USE Anweisung. In psql führst du \c other_db aus, das öffnet eine neue Verbindung; in der Shell startest du psql -d other_db.
Wie sehe ich in PostgreSQL die Größe von Tabellen?
In psql ergänzt \dt+ eine Spalte mit der Größe. In SQL liefert pg_size_pretty(pg_total_relation_size('orders')) die Größe einer Tabelle samt Indizes und TOAST-Daten.