...
← Curs SQL: toate lecțiile
Lecția 5 · Sintaxă

Comentarii în SQL

Comentariile sunt note pentru oameni, ignorate complet de baza de date. Le folosești ca să explici ce face o interogare sau ca să „oprești” temporar o bucată de cod fără să o ștergi.

Comentariu pe o singură linie: --

Tot ce urmează după două liniuțe --, până la capătul liniei, este comentariu:

-- Lista tuturor cărților din bibliotecă
SELECT * FROM carti;
titlu | autor | an_aparitie | pagini
Ion | Liviu Rebreanu | 1920 | 480
Enigma Otiliei | George Călinescu | 1938 | 416
Maitreyi | Mircea Eliade | 1933 | 208
Moromeții | Marin Preda | 1955 | 512
Baltagul | Mihail Sadoveanu | 1930 | 192
Amintiri din copilărie | Ion Creangă | 1892 | 160
Ciuleandra | Liviu Rebreanu | 1927 | 176
Pădurea spânzuraților | Liviu Rebreanu | 1922 | 336

Prima linie este doar pentru tine sau pentru colegii care citesc codul. Baza de date o sare și execută doar SELECT.

Exercițiul tău

Scrie o interogare care afișează coloanele titlu și autor din tabelul carti. Deasupra interogării adaugă un comentariu pe o linie (cu --) care explică ce face interogarea.

  • Scrie un comentariu cu -- pe prima linie.
  • Selectează titlu și autor din carti.
  • Rulează și verifică că apar doar cele două coloane.
Comentariul este ignorat la rulare, deci rezultatul conține doar titlu și autor.

Soluția exercițiului

-- Titlurile și autorii tuturor cărților
SELECT titlu, autor
FROM carti;
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Comentariu la finalul unei linii · Comentariu pe mai multe linii: /* */ · Comentarea temporară a unei coloane · Când să scrii comentarii · Exemple din viața reală

Comentariu la finalul unei linii

Poți pune -- și după cod, pe aceeași linie:

SELECT titlu, autor  -- doar două coloane
FROM carti;
titlu | autor
Ion | Liviu Rebreanu
Enigma Otiliei | George Călinescu
Maitreyi | Mircea Eliade
Moromeții | Marin Preda
Baltagul | Mihail Sadoveanu
Amintiri din copilărie | Ion Creangă
Ciuleandra | Liviu Rebreanu
Pădurea spânzuraților | Liviu Rebreanu
Bine de știut

În MySQL, după -- trebuie să urmeze obligatoriu un spațiu. Ca să fii sigur că merge peste tot, scrie mereu -- cu spațiu.

Comentariu pe mai multe linii: /* */

Pentru explicații mai lungi, scrii textul între /* și */. Totul dintre ele este ignorat, oricâte linii ar avea:

/*
  Raport: cărțile din bibliotecă
  Autor: echipa bibliotecii
*/
SELECT titlu, an_aparitie FROM carti;
titlu | an_aparitie
Ion | 1920
Enigma Otiliei | 1938
Maitreyi | 1933
Moromeții | 1955
Baltagul | 1930
Amintiri din copilărie | 1892
Ciuleandra | 1927
Pădurea spânzuraților | 1922

Comentarea temporară a unei coloane

Un truc foarte folosit: vrei să vezi rezultatul fără o coloană, dar nu vrei să o ștergi. Pui coloana pe linia ei și o comentezi:

SELECT titlu,
       autor
       -- , pagini
FROM carti;
titlu | autor
Ion | Liviu Rebreanu
Enigma Otiliei | George Călinescu
Maitreyi | Mircea Eliade
Moromeții | Marin Preda
Baltagul | Mihail Sadoveanu
Amintiri din copilărie | Ion Creangă
Ciuleandra | Liviu Rebreanu
Pădurea spânzuraților | Liviu Rebreanu

Când ai nevoie din nou de coloana pagini, ștergi doar -- și interogarea revine la forma inițială.

Atenție la virgule

Observă că virgula a fost pusă la începutul liniei comentate. Dacă ai fi comentat doar pagini și ai fi lăsat autor,, ai fi rămas cu o virgulă în plus înainte de FROM, adică o eroare de sintaxă.

Când să scrii comentarii

  • Ca să explici de ce există o interogare (de exemplu „raportul lunar pentru contabilitate”).
  • Ca să descrii o condiție mai greu de înțeles.
  • Ca să dezactivezi temporar o parte din cod în timp ce cauți o greșeală.
Sfat

Nu comenta lucrurile evidente. -- selectez titlul deasupra lui SELECT titlu nu ajută pe nimeni.

Exemple din viața reală

Rapoarte salvate

Firmele păstrează fișiere .sql cu rapoarte, iar comentariile spun cine le folosește și când.

Depanare

Programatorii comentează pe rând părți din interogare ca să găsească sursa unei erori.

Lucru în echipă

Un coleg înțelege mai repede o interogare explicată.

interogare.sqlSQL
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 Fundamente SQL Lecția 5 · Comentarii în SQL
Progres 0% 0 din 17
Lecția curentă 5 / 15 Sintaxă