Rezumat: în acest tutorial, veți învăța cum să utilizați comentariul MySQL pentru a documenta o instrucțiune SQL sau un bloc de cod în MySQL.
Comentariile pot fi utilizate pentru a documenta scopul o instrucțiune SQL sau logica unui bloc de cod într-o procedură stocată. Când se analizează codul SQL, MySQL ignoră partea de comentarii. Execută doar partea SQL, cu excepția comentariului executabil, pe care îl vom discuta în secțiunea următoare.
MySQL acceptă trei stiluri de comentarii:
- Din
"-- "
până la sfârșitul liniei. Stilul dublu-liniuță-comentariu necesită cel puțin un spațiu alb sau un caracter de control (spațiu, filă, linie nouă etc.) după a doua liniuță.SELECT * FROM users; -- This is a comment
Rețineți că SQL standard nu necesită un spațiu alb după a doua liniuță. MySQL folosește un spațiu alb pentru a evita problemele cu unele construcții SQL, cum ar fi:
SELECT 10--1;
Instrucțiunea returnează 11. Dacă MySQL nu ar folosi spațiul alb, ar fi returnează în schimb 10.
- De la un
"#"
la sfârșitul liniei.SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1002; # get subordinates of Diane
- Comentariul în stil C
/**/
poate cuprinde mai multe linii. Folosiți acest stil de comentariu pentru a documenta un bloc de cod SQL./* Get sales rep employees that reports to Anthony*/SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1143 AND jobTitle = "Sales Rep";
Observați că MySQL nu acceptă comentariile imbricate.
Comentarii executabile
MySQL oferă comentarii executabile pentru a sprijini portabilitatea între diferite baze de date. Aceste comentarii vă permit să încorporați cod SQL care se va executa numai în MySQL, dar nu și în alte baze de date.
Următoarele ilustrează sintaxa comentariilor executabile:
Code language: SQL (Structured Query Language) (sql)
De exemplu, următoarea instrucțiune folosește un comentariu executabil:
Code language: SQL (Structured Query Language) (sql)
Instrucțiunea returnează 2 în loc de 1. Cu toate acestea, va reveni 1 dacă executați în alte sisteme de baze de date.
Dacă doriți să executați un comentariu dintr-o anumită versiune de MySQL, utilizați următoarea sintaxă:
Code language: SQL (Structured Query Language) (sql)