Apostrofuri, ghilimele și nume de tabele
În PostgreSQL, apostroful și ghilimelele nu sunt interschimbabile: 'Ana' este un text, iar "Ana" este numele unei coloane. Tot aici apare o regulă care îi surprinde pe mulți: numele de tabele și coloane devin automat litere mici. În această lecție afli de ce, cum eviți erorile și cum scrii un text care conține chiar un apostrof.
Valori și identificatori
| Scriere | Ce este | Exemplu |
|---|---|---|
| '...' (apostrofuri) | o valoare text (un literal) | WHERE oras = 'Cluj' |
| "..." (ghilimele duble) | un identificator: nume de tabel, coloană, alias | SELECT "Total vânzări" |
| fără nimic | tot un identificator, transformat în litere mici | SELECT Nume FROM Clienti = SELECT nume FROM clienti |
Ghilimelele duble îți permit nume cu spații, diacritice sau majuscule, de exemplu un alias frumos pentru un raport:
SELECT 1250 AS "Total vânzări";
Total vânzări
---------------
1250
(1 rând)
Numele devin litere mici
Când scrii un nume fără ghilimele, PostgreSQL îl transformă în litere mici înainte de orice. De aceea Clienti, CLIENTI și clienti sunt același tabel:
CREATE TABLE Clienti (Id integer, Nume text); INSERT INTO CLIENTI VALUES (1, 'Ana'); SELECT NUME FROM clienti; \dt
CREATE TABLE
INSERT 0 1
nume
------
Ana
(1 rând)
Lista relațiilor
Schemă | Nume | Tip | Proprietar
--------+---------+-------+------------
public | clienti | tabel | postgres
(1 rând)
\dt arată adevărul: tabelul se numește clienti, iar coloana nume. Dacă pui însă numele între ghilimele, PostgreSQL păstrează exact literele, deci obții alt tabel:
CREATE TABLE Clienti (Nume text);
CREATE TABLE "Clienti" ("Nume" text);
\dtCREATE TABLE
CREATE TABLE
Lista relațiilor
Schemă | Nume | Tip | Proprietar
--------+---------+-------+------------
public | Clienti | tabel | postgres
public | clienti | tabel | postgres
(2 rânduri)
Ca să nu ai niciodată această problemă, numele de tabele și coloane se scriu în snake_case, cu litere mici și fără ghilimele: linii_comanda, pret_unitar, data_livrare. Le poți scrie apoi oricum în interogări și vor funcționa.
Greșeala clasică: textul între ghilimele duble
Cine vine din JavaScript, Java sau MySQL scrie des textele între ghilimele duble. În PostgreSQL, "Ana" înseamnă „coloana numită Ana”:
\set ON_ERROR_STOP off CREATE TABLE clienti (id integer, nume text); INSERT INTO clienti VALUES (1, 'Ana'); SELECT * FROM clienti WHERE nume = "Ana"; SELECT "Nume" FROM clienti; SELECT * FROM clienti WHERE nume = 'Ana';
CREATE TABLE
INSERT 0 1
ERROR: column "Ana" does not exist
LINE 1: SELECT * FROM clienti WHERE nume = "Ana";
^
ERROR: column "Nume" does not exist
LINE 1: SELECT "Nume" FROM clienti;
^
HINT: Perhaps you meant to reference the column "clienti.nume".
id | nume
----+------
1 | Ana
(1 rând)
Un apostrof în interiorul textului
Ce faci când textul conține el însuși un apostrof, ca în O'Brien sau Ceai d'Ardeal? Dacă scrii 'O'Brien', PostgreSQL crede că textul se termină după O și dă eroarea unterminated quoted string. Ai două soluții:
- dublezi apostroful: 'O''Brien' (două apostrofuri la rând înseamnă un apostrof în text);
- folosești dollar quoting: $$O'Brien$$; tot ce e între $$ și $$ se ia exact cum e scris.
SELECT 'O''Brien' AS nume, $$Ceai d'Ardeal$$ AS produs, 'Text cu "ghilimele" în el' AS citat;
nume | produs | citat ---------+---------------+--------------------------- O'Brien | Ceai d'Ardeal | Text cu "ghilimele" în el (1 rând)
În cod nu lipești niciodată textul primit de la utilizator direct în SQL: folosești parametri (? în JDBC, $1 în node-postgres). Driverul se ocupă singur de apostrofuri și te protejează de SQL injection.
Rezumat
Apostrofurile sunt pentru valori: WHERE oras = 'Cluj'.
Ghilimelele duble sunt pentru nume de tabele, coloane și aliasuri; păstrează exact literele.
Numele fără ghilimele devin litere mici: Clienti = clienti.
'd''Ardeal' sau $$d'Ardeal$$.
Verifică cu ochii tăi cum transformă PostgreSQL numele scrise cu majuscule.
- Creează tabelul ProduseNoi (scris așa, fără ghilimele) cu o singură coloană Nume text.
- Inserează produsul Ceai d'Ardeal (atenție la apostrof).
- Afișează toate coloanele tabelului.
- Afișează lista tabelelor cu \dt și observă numele real al tabelului.
Soluția exercițiului
CREATE TABLE ProduseNoi (Nume text);
INSERT INTO ProduseNoi VALUES ('Ceai d''Ardeal');
SELECT * FROM ProduseNoi;
\dt 