CREATE TABLE name (column type constraints, ...) crea una tabella. Ogni colonna riceve un nome e un tipo di dato, poi eventuali vincoli come PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE o CHECK.
La colonna id si numera da sola, plan prende 'free' quando l'insert non la specifica, e created_at registra il momento dell'inserimento. La pagina sui tipi di dati elenca i tipi di colonna più comuni.
Vincoli di colonna
| Vincolo | Effetto |
|---|---|
PRIMARY KEY | Unico e non nullo; uno per tabella |
NOT NULL | La colonna deve avere un valore |
DEFAULT expr | Valore usato quando un insert omette la colonna |
UNIQUE | Due righe non possono avere lo stesso valore (più NULL sono ammessi) |
CHECK (expr) | Rifiuta le righe in cui l'espressione è falsa |
REFERENCES t (col) | Chiave esterna verso un'altra tabella |
Da PostgreSQL 15, UNIQUE NULLS NOT DISTINCT considera uguali i NULL, quindi solo una riga può avere NULL in quella colonna.
Regole su più colonne
Un vincolo su più di una colonna va su una riga a parte, dopo le colonne. Dargli un nome con CONSTRAINT name rende leggibili i messaggi di errore e ti permette in seguito di eliminarlo per nome.
La query elenca i tre vincoli. Quelli senza nome hanno ricevuto nomi generati, bookings_guests_check e bookings_pkey.
Creare una tabella solo se non esiste
IF NOT EXISTS trasforma il secondo CREATE TABLE in un avviso invece che in un errore. Controlla solo il nome. Se esiste già una tabella chiamata logs con colonne diverse, non cambia niente.
Creare una tabella da una query o da un'altra tabella
CREATE TABLE ... AS crea una tabella dal risultato di una SELECT, con le colonne e i tipi del risultato. LIKE copia la definizione di un'altra tabella senza le sue righe, e INCLUDING ALL porta con sé valori predefiniti, vincoli, identity e indici.
big_orders ha una riga. orders_archive ha le colonne e i vincoli di orders e nessuna riga.
Colonne generate
Una colonna generata viene calcolata da altre colonne della stessa riga, e gli insert non possono scriverla. In PostgreSQL 17 deve essere STORED: il valore viene calcolato in scrittura e salvato su disco.
I totali sono 13.5 e 20.
Tabelle temporanee e unlogged
CREATE TEMP TABLE crea una tabella visibile solo alla sessione corrente, che viene eliminata quando la sessione termina. È adatta ai risultati intermedi di uno script lungo. CREATE UNLOGGED TABLE salta il write-ahead log, quindi le scritture sono più veloci. La tabella viene svuotata dopo un crash e non viene copiata sulle repliche, quindi usala solo per dati che puoi ricostruire.
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
Per modificare una tabella dopo averla creata, usa ALTER TABLE. Tutte le opzioni sono elencate nel riferimento di CREATE TABLE.
Domande frequenti
I nomi delle tabelle in PostgreSQL distinguono maiuscole e minuscole?
I nomi senza virgolette vengono convertiti in minuscolo, quindi CREATE TABLE Users crea users. Un nome tra virgolette come "Users" mantiene le maiuscole e va poi messo tra virgolette in ogni query, ed è per questo che la norma sono i nomi in minuscolo in snake_case.
Come vedo la struttura di una tabella in PostgreSQL?
In psql, \d table_name mostra colonne, tipi, valori predefiniti, indici e vincoli. Da SQL, interroga information_schema.columns WHERE table_name = 'table_name'.
Come copio una tabella in PostgreSQL?
CREATE TABLE copy AS TABLE original; copia colonne e righe ma nessun vincolo né indice. CREATE TABLE copy (LIKE original INCLUDING ALL); copia la struttura con valori predefiniti, vincoli e indici ma nessuna riga.
Come elimino una tabella in PostgreSQL?
DROP TABLE table_name; rimuove la tabella e i suoi dati. DROP TABLE IF EXISTS table_name; evita l'errore quando la tabella non esiste, e CASCADE elimina anche le viste e le chiavi esterne che dipendono da essa.