Resumé: I denne vejledning lærer du, hvordan du bruger MySQL-kommentar til at dokumentere en SQL-sætning eller en kodeblok i MySQL.
Kommentarer kan bruges til at dokumentere formålet med en SQL-sætning eller logikken i en kodeblok i en lagret procedure. Når du analyserer SQL-kode, ignorerer MySQL kommentardelen. Det udfører kun SQL-delen undtagen eksekverbar kommentar, som vi vil diskutere i det næste afsnit.
MySQL understøtter tre kommentarformater:
- Fra en
"-- "
til slutningen af linjen. Den dobbelte bindestreg-kommentar-stil kræver mindst mellemrum eller kontroltegn (mellemrum, fane, ny linje osv.) Efter det andet bindestreg.SELECT * FROM users; -- This is a comment
Bemærk, at standard SQL ikke kræver en mellemrum efter det andet bindestreg. MySQL bruger et hvidt område for at undgå problemer med nogle SQL-konstruktioner som:
SELECT 10--1;
Erklæringen returnerer 11. Hvis MySQL ikke brugte det hvide område, ville det returner 10 i stedet.
- Fra en
"#"
til slutningen af linjen.SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1002; # get subordinates of Diane
- C-stil kommentar
/**/
kan spænde over flere linjer. Du bruger denne kommentarstil til at dokumentere en blok af SQL-kode./* Get sales rep employees that reports to Anthony*/SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1143 AND jobTitle = "Sales Rep";
Bemærk, at MySQL ikke understøtter indlejrede kommentarer.
Eksekverbare kommentarer
MySQL giver eksekverbare kommentarer til understøttelse af bærbarhed mellem forskellige databaser. Disse kommentarer giver dig mulighed for at integrere SQL-kode, der kun udføres i MySQL, men ikke andre databaser.
Følgende illustrerer den eksekverbare kommentarsyntaks:
Code language: SQL (Structured Query Language) (sql)
For eksempel bruger følgende udsagn en eksekverbar kommentar:
Code language: SQL (Structured Query Language) (sql)
Erklæringen returnerer 2 i stedet for 1. Den returnerer dog 1, hvis du udfører det i andre databasesystemer.
Hvis du vil udføre en kommentar fra en bestemt version af MySQL, bruger du følgende syntaks:
Code language: SQL (Structured Query Language) (sql)