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.
| Comanda | Ce afișează |
|---|---|
| \dt | lista tabelelor |
| \d nume | structura unui tabel: coloane, tipuri, valori implicite, indecși, constrângeri |
| \dn | lista schemelor (le vei folosi mai târziu) |
| \x | pornește sau oprește afișarea extinsă (o coloană pe rând) |
| \echo text | afișează un text, util ca titlu între rezultate |
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)
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
Ce tabele există, în ce schemă și cine le deține.
Coloane, tipuri, obligativitate, valori implicite, indecși și constrângeri.
Afișare extinsă pentru rânduri late: o coloană pe rând.
Un text simplu între rezultate, ca titlu sau mesaj.
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.
Soluția exercițiului
\dt \d comenzi \x SELECT * FROM comenzi WHERE id = 1;
