Primul tabel în PostgreSQL
Știi deja CREATE TABLE și INSERT din cursul de SQL. În PostgreSQL ele arată la fel, dar fiecare coloană are un tip strict, iar INSERT îți poate întoarce imediat rândurile salvate cu RETURNING. În această lecție creezi primul tău tabel PostgreSQL și îl verifici cu \d.
Tipurile de bază
Pentru început îți ajung cinci tipuri. Le vei folosi în aproape orice tabel:
| Tip | Ce păstrează | Exemplu |
|---|---|---|
| integer | numere întregi (până la circa 2,1 miliarde) | 42, -7 |
| text | texte de orice lungime | 'PostgreSQL de la zero' |
| numeric(10,2) | numere zecimale exacte: 10 cifre în total, 2 după virgulă | 349.90 |
| boolean | adevărat sau fals | true, false |
| date | o zi calendaristică, scrisă AAAA-LL-ZZ | '2025-03-14' |
Prețurile și sumele se țin în numeric, care calculează exact, fără erorile de rotunjire ale numerelor cu virgulă mobilă. Vei vedea de ce într-o lecție următoare.
CREATE TABLE cu cheie primară
Creăm un tabel pentru cursurile unei platforme online. PRIMARY KEY face coloana id unică și obligatorie, iar NOT NULL obligă fiecare curs să aibă un titlu:
CREATE TABLE cursuri (
id integer PRIMARY KEY,
titlu text NOT NULL,
pret numeric(10,2),
activ boolean,
lansat date
);
\d cursuriCREATE TABLE
Tabelul „public.cursuri”
Coloană | Tip | Nullable | Implicit
---------+---------------+----------+----------
id | integer | not null |
titlu | text | not null |
pret | numeric(10,2) | |
activ | boolean | |
lansat | date | |
Indecși:
"cursuri_pkey" PRIMARY KEY, btree (id)
INSERT cu mai multe rânduri și RETURNING
Un singur INSERT poate adăuga mai multe rânduri. Clauza RETURNING (o noutate față de SQLite-ul vechi) îți întoarce ce s-a salvat, ca și cum ai fi făcut imediat un SELECT:
CREATE TABLE cursuri (
id integer PRIMARY KEY,
titlu text NOT NULL,
pret numeric(10,2),
activ boolean,
lansat date
);
INSERT INTO cursuri VALUES
(1, 'SQL de la zero', 149.00, true, '2024-09-01'),
(2, 'PostgreSQL în practică', 349.90, true, '2025-03-01'),
(3, 'Python pentru începători', 199.50, false, '2023-11-15')
RETURNING *;CREATE TABLE id | titlu | pret | activ | lansat ----+--------------------------+--------+-------+------------ 1 | SQL de la zero | 149.00 | t | 2024-09-01 2 | PostgreSQL în practică | 349.90 | t | 2025-03-01 3 | Python pentru începători | 199.50 | f | 2023-11-15 (3 rânduri) INSERT 0 3
Observă ordinea: întâi tabelul cu rândurile întoarse, apoi eticheta INSERT 0 3. Coloana activ afișează t și f, prescurtările lui true și false în psql.
Poți cere doar câteva coloane din RETURNING:
CREATE TABLE cursuri (
id integer PRIMARY KEY,
titlu text NOT NULL,
pret numeric(10,2),
activ boolean,
lansat date
);
INSERT INTO cursuri (id, titlu, pret) VALUES (10, 'Git pentru echipe', 99.00)
RETURNING id, titlu;CREATE TABLE id | titlu ----+------------------- 10 | Git pentru echipe (1 rând) INSERT 0 1
De ce contează RETURNING în aplicații
Când o aplicație salvează o comandă, are nevoie imediat de id-ul ei (pentru pagina de confirmare, pentru email). Fără RETURNING ar trebui o a doua interogare, iar între cele două altcineva ar putea insera alt rând. Cu RETURNING, primești datele în același pas, sigur și mai rapid.
În al doilea exemplu am dat valori doar pentru id, titlu și pret. Coloanele activ și lansat au primit NULL, pentru că nu au valoare implicită și nu sunt NOT NULL.
Greșeli frecvente
- Același id de două ori: ERROR: duplicate key value violates unique constraint "cursuri_pkey". Cheia primară nu acceptă dubluri.
- Lipsa unei valori pentru o coloană NOT NULL: ERROR: null value in column "titlu" ... violates not-null constraint.
- Data scrisă în alt format, de exemplu '14.03.2025': folosește formatul standard '2025-03-14', pe care PostgreSQL îl înțelege mereu.
- Virgulă după ultima coloană din CREATE TABLE: syntax error at or near ")".
Rezumat
- Tipurile de bază: integer, text, numeric(p,s), boolean, date.
- PRIMARY KEY = unic + NOT NULL, cu un index creat automat.
- INSERT ... VALUES (...), (...) adaugă mai multe rânduri dintr-o dată.
- RETURNING * sau RETURNING col1, col2 întoarce rândurile salvate, apoi eticheta INSERT 0 n.
- \d tabel îți confirmă tipurile și constrângerile.
Creează tabelul unei librării online, adaugă trei cărți și verifică structura.
- Creează tabelul carti cu coloanele: id integer PRIMARY KEY, titlu text NOT NULL, autor text, pret numeric(8,2), in_stoc boolean.
- Inserează, cu un singur INSERT, cărțile: (1, Ion, Liviu Rebreanu, 39.90, true), (2, Maitreyi, Mircea Eliade, 34.50, false), (3, Enigma Otiliei, George Călinescu, 45.00, true).
- Folosește RETURNING id, titlu ca să vezi ce s-a salvat.
- Afișează structura tabelului cu \d carti.
Soluția exercițiului
CREATE TABLE carti (
id integer PRIMARY KEY,
titlu text NOT NULL,
autor text,
pret numeric(8,2),
in_stoc boolean
);
INSERT INTO carti VALUES
(1, 'Ion', 'Liviu Rebreanu', 39.90, true),
(2, 'Maitreyi', 'Mircea Eliade', 34.50, false),
(3, 'Enigma Otiliei', 'George Călinescu', 45.00, true)
RETURNING id, titlu;
\d carti 