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

Cum citești ieșirea psql

Orice programator care lucrează cu PostgreSQL ajunge să citească zilnic rezultatele din psql. În această lecție înveți ce înseamnă fiecare parte a unui tabel afișat și ce îți spun mesajele scurte ca INSERT 0 3 sau UPDATE 2, care apar după comenzile ce modifică date.

Anatomia unui tabel afișat

Când o interogare întoarce rânduri, psql le afișează într-un format aliniat. Pornim de la un tabel mic cu filme, creat și completat chiar în script:

CREATE TABLE filme (titlu text, an integer, nota numeric(3,1));
INSERT INTO filme VALUES ('Moromeții', 1987, 9.1), ('Filantropica', 2002, 8.4), ('Inception', 2010, 8.8);
SELECT * FROM filme;
CREATE TABLE
INSERT 0 3
    titlu     |  an  | nota
--------------+------+------
 Moromeții    | 1987 |  9.1
 Filantropica | 2002 |  8.4
 Inception    | 2010 |  8.8
(3 rânduri)
1
CREATE TABLE și INSERT 0 3 sunt etichetele comenzilor care nu întorc rânduri (le explicăm mai jos).
2
Antetul conține numele coloanelor, centrate deasupra fiecărei coloane.
3
Linia de liniuțe, cu + la intersecții, desparte antetul de date; | desparte coloanele.
4
Coloanele de numere (an, nota) sunt aliniate la dreapta, textele (titlu) la stânga.
5
Subsolul (3 rânduri) spune câte rânduri a întors interogarea, iar după fiecare tabel urmează o linie goală.
De ce contează alinierea

Alinierea nu este doar estetică: îți arată tipul coloanei. Dacă o coloană cu cifre apare aliniată la stânga, ea este de fapt text, nu un număr, și orice sortare sau calcul pe ea se va comporta altfel decât te aștepți.

Etichetele comenzilor

Comenzile care nu întorc rânduri (CREATE, INSERT, UPDATE, DELETE) afișează o etichetă: numele comenzii și, unde are sens, câte rânduri a afectat. Aceleași etichete le primește și aplicația ta (Java, Node.js, Python) de la server.

EtichetaCe înseamnă
CREATE TABLEtabelul a fost creat
INSERT 0 3s-au inserat 3 rânduri; 0 este un câmp istoric (oid), mereu 0 astăzi
UPDATE 2s-au modificat 2 rânduri
DELETE 1s-a șters un rând
UPDATE 0comanda a rulat corect, dar condiția WHERE nu a găsit niciun rând
CREATE TABLE filme (titlu text, an integer, nota numeric(3,1));
INSERT INTO filme VALUES ('Moromeții', 1987, 9.1), ('Filantropica', 2002, 8.4), ('Inception', 2010, 8.8);
UPDATE filme SET nota = 9.0 WHERE an < 2005;
DELETE FROM filme WHERE titlu = 'Inception';
UPDATE filme SET nota = 10 WHERE an > 2020;
CREATE TABLE
INSERT 0 3
UPDATE 2
DELETE 1
UPDATE 0
UPDATE 0 nu este o eroare

UPDATE 0 înseamnă că nu s-a potrivit niciun rând. În aplicații reale, acesta e un semnal important: de exemplu, un client încearcă să modifice o comandă care nu există sau nu îi aparține. Codul aplicației verifică numărul de rânduri afectate și afișează un mesaj.

Subsolul: 0, 1 sau mai multe rânduri

Subsolul se adaptează numărului de rânduri: (0 rânduri), (1 rând), (2 rânduri). O interogare care nu găsește nimic afișează doar antetul:

CREATE TABLE filme (titlu text, an integer, nota numeric(3,1));
INSERT INTO filme VALUES ('Moromeții', 1987, 9.1), ('Filantropica', 2002, 8.4), ('Inception', 2010, 8.8);
SELECT titlu FROM filme WHERE an = 1990;
SELECT titlu, an FROM filme WHERE nota > 9;
CREATE TABLE
INSERT 0 3
 titlu
-------
(0 rânduri)

   titlu   |  an
-----------+------
 Moromeții | 1987
(1 rând)

Un rezultat cu (0 rânduri) nu înseamnă că ai greșit ceva: interogarea este corectă, doar că nu există date care să respecte condiția.

Cum arată NULL

O valoare lipsă (NULL) se afișează în acest laborator chiar cu textul NULL, ca să o deosebești de un text gol '', care apare ca o celulă goală:

CREATE TABLE filme (titlu text, an integer, nota numeric(3,1));
INSERT INTO filme VALUES ('Moromeții', 1987, 9.1), ('Film nou', 2025, NULL), ('', 2024, 7.5);
SELECT * FROM filme;
CREATE TABLE
INSERT 0 3
   titlu   |  an  | nota
-----------+------+------
 Moromeții | 1987 |  9.1
 Film nou  | 2025 | NULL
           | 2024 |  7.5
(3 rânduri)
În psql-ul real

Pe un server obișnuit, psql afișează NULL ca o celulă goală, deci nu vezi diferența față de ''. Comanda \pset null 'NULL' (sau orice alt text) îi spune lui psql cum să afișeze valorile lipsă. Mulți programatori o pun în fișierul de configurare ~/.psqlrc.

Greșeli frecvente

  • Să crezi că INSERT 0 3 înseamnă „0 rânduri inserate”. Numărul care contează este ultimul: 3 rânduri.
  • Să ignori UPDATE 0 sau DELETE 0: comanda a mers, dar condiția WHERE nu a găsit nimic. Verifică valoarea din condiție.
  • Să uiți ORDER BY: fără el, ordinea rândurilor nu este garantată. Pe tabele mici pare stabilă, pe serverul real se poate schimba după un UPDATE.
  • Să confunzi o celulă goală cu NULL: în laborator NULL apare scris, iar textul gol rămâne gol.

Rezumat

1Tabelul

Antet centrat, linie de liniuțe, numere la dreapta, texte la stânga, apoi (N rânduri).

2Etichetele

CREATE TABLE, INSERT 0 3, UPDATE 2, DELETE 1: ultimul număr este numărul de rânduri afectate.

3NULL

În laborator apare NULL; în psql real e gol, iar \pset null schimbă afișarea.

4În aplicații

Driverele (JDBC, node-postgres, psycopg) primesc aceleași numere de rânduri afectate și le folosesc în cod.

Exercițiul tău

Creează un tabel cu orașe, completează-l, modifică un rând și afișează rezultatul. Urmărește etichetele fiecărei comenzi.

  • Creează tabelul orase cu coloanele nume text, judet text, populatie integer.
  • Inserează, cu un singur INSERT, orașele: Cluj-Napoca (Cluj, 286598), Timișoara (Timiș, 250849), Brașov (Brașov, 237589).
  • Actualizează populația orașului Brașov la 238000.
  • Afișează toate coloanele tabelului, ordonate după nume.
Un singur INSERT INTO orase VALUES (...), (...), (...);, apoi UPDATE orase SET populatie = ... WHERE nume = 'Brașov'; și SELECT * FROM orase ORDER BY nume;.

Soluția exercițiului

CREATE TABLE orase (nume text, judet text, populatie integer);
INSERT INTO orase VALUES
    ('Cluj-Napoca', 'Cluj', 286598),
    ('Timișoara', 'Timiș', 250849),
    ('Brașov', 'Brașov', 237589);
UPDATE orase SET populatie = 238000 WHERE nume = 'Brașov';
SELECT * FROM orase ORDER BY nume;
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 2 · Cum citești ieșirea psql
Progres 0% 0 din 12
Lecția curentă 2 / 10 Introducere