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

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

ScriereCe esteExemplu
'...' (apostrofuri)o valoare text (un literal)WHERE oras = 'Cluj'
"..." (ghilimele duble)un identificator: nume de tabel, coloană, aliasSELECT "Total vânzări"
fără nimictot un identificator, transformat în litere miciSELECT 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);
\dt
CREATE TABLE
CREATE TABLE
           Lista relațiilor
 Schemă |  Nume   |  Tip  | Proprietar
--------+---------+-------+------------
 public | Clienti | tabel | postgres
 public | clienti | tabel | postgres
(2 rânduri)
Convenția din industrie

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)
1
column "Ana" does not exist: PostgreSQL a căutat o coloană numită Ana. Soluția: 'Ana' cu apostrofuri.
2
column "Nume" does not exist: cu ghilimele, "Nume" (cu N mare) nu este același lucru cu coloana nume. HINT-ul îți sugerează chiar numele corect.
3
Ultima interogare, cu apostrofuri, merge.

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)
Și în aplicații

Î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

1'text'

Apostrofurile sunt pentru valori: WHERE oras = 'Cluj'.

2"Nume"

Ghilimelele duble sunt pentru nume de tabele, coloane și aliasuri; păstrează exact literele.

3litere mici

Numele fără ghilimele devin litere mici: Clienti = clienti.

4apostroful

'd''Ardeal' sau $$d'Ardeal$$.

Exercițiul tău

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.
Apostroful din text se dublează: 'Ceai d''Ardeal' (sau folosește $$Ceai d'Ardeal$$).

Soluția exercițiului

CREATE TABLE ProduseNoi (Nume text);
INSERT INTO ProduseNoi VALUES ('Ceai d''Ardeal');
SELECT * FROM ProduseNoi;
\dt
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 7 · Apostrofuri, ghilimele și nume de tabele
Progres 0% 0 din 12
Lecția curentă 7 / 10 Introducere