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

Comenzile psql: \d, \dt și \x

Când ajungi pe o bază de date nouă, prima întrebare este: „ce tabele sunt aici și cum arată?”. psql are pentru asta niște comenzi scurte, care încep cu backslash (\). În această lecție explorezi baza de date a unui magazin online cu \dt, \d și \x.

Meta-comenzi: nu sunt SQL

Comenzile care încep cu \ se numesc meta-comenzi. Ele nu ajung la server ca SQL: le interpretează psql, clientul, care trimite în spate interogări pe catalogul bazei de date și îți arată rezultatul frumos formatat.

ComandaCe afișează
\dtlista tabelelor
\d numestructura unui tabel: coloane, tipuri, valori implicite, indecși, constrângeri
\dnlista schemelor (le vei folosi mai târziu)
\xpornește sau oprește afișarea extinsă (o coloană pe rând)
\echo textafișează un text, util ca titlu între rezultate
Regula de scriere

O meta-comandă stă la început de rând și **nu se termină cu ;**. Restul rândului sunt argumentele ei. Dacă scrii \dt;, psql caută un tabel numit ;.

Ce tabele există: \dt

În laborator, baza de date a lecției conține tabelele unui magazin online. \dt le listează:

\dt
              Lista relațiilor
 Schemă |     Nume      |  Tip  | Proprietar
--------+---------------+-------+------------
 public | categorii     | tabel | postgres
 public | clienti       | tabel | postgres
 public | comenzi       | tabel | postgres
 public | linii_comanda | tabel | postgres
 public | produse       | tabel | postgres
(5 rânduri)

Fiecare rând îți spune schema (public este schema implicită, ca un dosar în care stau tabelele), numele, tipul relației și proprietarul (rolul care a creat tabelul).

Structura unui tabel: \d

\d produse îți arată tot ce trebuie să știi despre tabelul produse înainte să scrii o interogare:

\d produse
                          Tabelul „public.produse”
   Coloană    |      Tip      | Nullable |             Implicit
--------------+---------------+----------+----------------------------------
 id           | integer       | not null | generated by default as identity
 nume         | text          | not null |
 categorie_id | integer       | not null |
 pret         | numeric(10,2) | not null |
 stoc         | integer       | not null | 0
 detalii      | jsonb         |          |
Indecși:
    "produse_pkey" PRIMARY KEY, btree (id)
Constrângeri de verificare:
    "produse_pret_check" CHECK (pret > 0::numeric)
Constrângeri de cheie străină:
    "produse_categorie_id_fkey" FOREIGN KEY (categorie_id) REFERENCES categorii(id)
Referit de:
    TABLE "linii_comanda" CONSTRAINT "linii_comanda_produs_id_fkey" FOREIGN KEY (produs_id) REFERENCES produse(id)
1
Lista coloanelor: numele, tipul (integer, text, numeric(10,2), jsonb), dacă acceptă NULL (not null = obligatoriu) și valoarea implicită (stoc are 0, id este generat automat).
2
Indecși: produse_pkey este indexul cheii primare, creat automat de PostgreSQL.
3
Constrângeri de verificare: CHECK (pret > 0) respinge prețurile negative sau zero.
4
Constrângeri de cheie străină: categorie_id trebuie să existe în categorii.
5
Referit de: ce alte tabele trimit spre acesta (linii_comanda folosește produse.id).
În proiectele reale

Când primești un task pe o bază de date pe care nu o cunoști, \d tabel este primul lucru pe care îl rulezi. Îți spune ce coloane sunt obligatorii și ce reguli va verifica serverul la fiecare INSERT, deci eviți erorile înainte să le faci.

Rânduri late: afișarea extinsă \x

Un rând cu multe coloane sau cu texte lungi iese foarte lat și greu de citit. Cu \x, fiecare coloană apare pe un rând separat, ca o fișă:

\x
SELECT * FROM produse WHERE id = 1;
\x off
\echo Înapoi la afișarea normală
SELECT id, nume FROM produse WHERE id = 1;
Afișarea extinsă este activată.
-[ RÂNDUL 1 ]-------------------------------------------------------------------
id           | 1
nume         | Laptop Nova 14
categorie_id | 1
pret         | 3499.90
stoc         | 5
detalii      | {"ram": 16, "culori": ["gri", "negru"], "garantie": {"luni": 24}}

Afișarea extinsă este dezactivată.
Înapoi la afișarea normală
 id |      nume
----+----------------
  1 | Laptop Nova 14
(1 rând)
  • Prima comandă \x comută afișarea; \x on și \x off o pornesc, respectiv o opresc explicit.
  • Fiecare rând al rezultatului începe cu -[ RÂNDUL 1 ]---, apoi perechi coloană | valoare.
  • \echo afișează textul exact cum l-ai scris, fără ghilimele.

Greșeli frecvente

  • \dt; sau \d produse; cu punct și virgulă: meta-comenzile nu se termină cu ;.
  • Meta-comanda pusă în mijlocul unui rând SQL, de exemplu SELECT 1; \dt: scrie-o pe un rând separat.
  • Să cauți \dt în aplicația Java sau Node.js: meta-comenzile există doar în psql. Din cod folosești interogări pe information_schema sau pg_catalog, pe care le vei vedea mai târziu.
  • Să uiți \x activ: toate rezultatele următoare vor apărea ca fișe, până la \x off.

Rezumat

1\dt

Ce tabele există, în ce schemă și cine le deține.

2\d tabel

Coloane, tipuri, obligativitate, valori implicite, indecși și constrângeri.

3\x

Afișare extinsă pentru rânduri late: o coloană pe rând.

4\echo

Un text simplu între rezultate, ca titlu sau mesaj.

Exercițiul tău

Explorează baza de date a magazinului folosind meta-comenzile psql.

  • Afișează lista tabelelor cu \dt.
  • Afișează structura tabelului comenzi cu \d comenzi.
  • Activează afișarea extinsă cu \x, apoi afișează toate coloanele comenzii cu id 1.
Fiecare meta-comandă pe rândul ei, fără ;. După \x urmează SELECT * FROM comenzi WHERE id = 1;.

Soluția exercițiului

\dt
\d comenzi
\x
SELECT * FROM comenzi WHERE id = 1;
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 3 · Comenzile psql: \d, \dt și \x
Progres 0% 0 din 12
Lecția curentă 3 / 10 Introducere