...
← Curs PostgreSQL: toate lecțiile
Lecția 4 · Introducere

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:

TipCe păstreazăExemplu
integernumere întregi (până la circa 2,1 miliarde)42, -7
texttexte de orice lungime'PostgreSQL de la zero'
numeric(10,2)numere zecimale exacte: 10 cifre în total, 2 după virgulă349.90
booleanadevărat sau falstrue, false
dateo zi calendaristică, scrisă AAAA-LL-ZZ'2025-03-14'
numeric(10,2) pentru bani

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 cursuri
CREATE 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)
1
CREATE TABLE confirmă că tabelul a fost creat.
2
În \d, coloana pret apare cu tipul exact numeric(10,2).
3
id și titlu sunt not null: PRIMARY KEY implică automat NOT NULL.
4
La Indecși, PostgreSQL a creat singur indexul cursuri_pkey pentru cheia primară.

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.

Coloanele nelistate

Î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.
Exercițiul tău

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.
INSERT INTO carti VALUES (...), (...), (...) RETURNING id, titlu; apoi, pe rând nou, \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
Excelent! Continuă cu lecția următoare →
script.sqlPostgreSQL
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu PostgreSQL Lecția 4 · Primul tabel în PostgreSQL
Progres 0% 0 din 12
Lecția curentă 4 / 10 Introducere