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.
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.
Soluția exercițiului
-- Titlurile și autorii tuturor cărților SELECT titlu, autor FROM carti;
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
Î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ă.
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ă.
Nu comenta lucrurile evidente. -- selectez titlul deasupra lui SELECT titlu nu ajută pe nimeni.
Exemple din viața reală
Firmele păstrează fișiere .sql cu rapoarte, iar comentariile spun cine le folosește și când.
Programatorii comentează pe rând părți din interogare ca să găsească sursa unei erori.
Un coleg înțelege mai repede o interogare explicată.
