In psql, \l elenca i database, \c dbname si connette a uno di essi e \dt elenca le tabelle del database corrente. Da SQL o da qualsiasi altro client, interroga i cataloghi: pg_database per i database e information_schema.tables per le tabelle.
Restituisce le due tabelle come BASE TABLE e la vista come VIEW, tutte nello schema public. Il filtro WHERE nasconde i cataloghi di sistema, che altrimenti aggiungerebbero centinaia di righe. Aggiungi AND table_type = 'BASE TABLE' per escludere le viste.
Comandi psql per database e tabelle
Questi sono meta comandi di psql. psql trasforma ognuno di essi in una query sui cataloghi, quindi non funzionano in altri client né nel codice di un'applicazione.
| Comando | Mostra |
|---|---|
\l | I database (\l+ aggiunge le dimensioni) |
\c shop | Si connette al database shop |
\conninfo | Il database, l'utente e l'host su cui sei |
\dn | Gli schemi |
\dt | Le tabelle negli schemi del tuo search_path |
\dt sales.* | Le tabelle nello schema sales |
\dt *.* | Le tabelle in ogni schema, compresi quelli di sistema |
\dt+ | Le tabelle con dimensione e descrizione |
\dv, \di, \ds | Viste, indici, sequenze |
\d orders | Colonne, indici e vincoli di orders |
\d+ orders | Lo stesso più storage e commenti |
\du | I ruoli |
Dalla shell, psql -l stampa l'elenco dei database ed esce, e -c esegue un solo comando:
psql -l
psql -d shop -c '\dt'
Avvia psql con -E per stampare l'SQL dietro ogni meta comando. È un modo rapido per imparare le tabelle dei cataloghi.
Elencare i database con SQL
Ogni database del server è una riga di pg_database. template0 e template1 sono i modelli che CREATE DATABASE copia, quindi escludili:
In questa pagina ogni esecuzione riceve un database nuovo il cui nome inizia con lesson_. Il risultato mostra quello e postgres, il database predefinito che ogni server crea. SELECT current_database() restituisce quello a cui sei connesso.
Descrivere le colonne di una tabella
In psql, \d orders descrive la tabella. In SQL, information_schema.columns contiene una riga per colonna:
id mostra NO sotto is_nullable perché una chiave primaria è sempre NOT NULL. Il suo column_default è vuoto: una colonna identity prende i valori da una sequenza, non da un valore predefinito.
Interrogare direttamente pg_catalog
information_schema è la vista dello standard SQL e mostra solo gli oggetti su cui hai qualche privilegio. I cataloghi specifici di PostgreSQL in pg_catalog contengono di più, come le definizioni degli indici:
Elenca tre indici: orders_email_key da UNIQUE, orders_pkey dalla chiave primaria e quello parziale che hai creato. Ognuno arriva con l'istruzione CREATE INDEX che lo ricreerebbe. pg_tables elenca solo le tabelle; pg_views e pg_matviews coprono le viste e le viste materializzate.
Contare le righe di ogni tabella
I cataloghi non salvano il numero esatto di righe. pg_class.reltuples contiene la stima del planner, che VACUUM e ANALYZE aggiornano. È abbastanza precisa per individuare le tabelle grandi, e -1 significa che la tabella non è mai stata analizzata:
SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;
Per un numero esatto, esegui SELECT count(*) FROM orders, che legge tutta la tabella. Le tabelle dei cataloghi sono documentate in System Catalogs nel manuale di PostgreSQL.
Domande frequenti
PostgreSQL ha SHOW TABLES o SHOW DATABASES?
No, sono comandi di MySQL. In PostgreSQL, SHOW legge un'impostazione del server, quindi SHOW TABLES fallisce con "unrecognized configuration parameter". Usa \dt e \l in psql, oppure interroga information_schema.tables e pg_database.
Perché \dt dice "Did not find any relations"?
O sei connesso a un database diverso da quello che contiene le tabelle, oppure le tabelle sono in uno schema che non è nel tuo search_path. Controlla \conninfo, poi prova \dt *.* o \dt schema_name.*.
Come cambio database in PostgreSQL?
Una connessione appartiene a un solo database, e in SQL non esiste un'istruzione USE. In psql esegui \c other_db, che apre una nuova connessione; dalla shell, avvia psql -d other_db.
Come vedo la dimensione delle tabelle in PostgreSQL?
In psql, \dt+ aggiunge una colonna con la dimensione. In SQL, pg_size_pretty(pg_total_relation_size('orders')) dà la dimensione di una tabella compresi i suoi indici e i dati TOAST.