Sammanfattning: i denna handledning lär du dig hur du använder MySQL-kommentar för att dokumentera ett SQL-uttalande eller ett kodblock i MySQL.
Kommentarer kan användas för att dokumentera syftet med en SQL-sats eller logiken för ett kodblock i en lagrad procedur. När du analyserar SQL-kod ignorerar MySQL kommentardelen. Den kör bara SQL-delen förutom körbar kommentar, som vi kommer att diskutera i nästa avsnitt.
MySQL stöder tre kommentarstilar:
- Från en
"-- "
till slutet av raden. Dubbelstreck-kommentarstilen kräver åtminstone mellanslag eller kontrolltecken (mellanslag, flik, ny rad osv.) Efter det andra strecket.SELECT * FROM users; -- This is a comment
Observera att standard-SQL inte kräver mellanslag efter det andra strecket. MySQL använder ett mellanslag för att undvika problem med vissa SQL-konstruktioner som:
SELECT 10--1;
Uttalandet returnerar 11. Om MySQL inte använde det vita utrymmet skulle det returnera 10 istället.
- Från en
"#"
till slutet av raden.SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1002; # get subordinates of Diane
- Kommentar i C-stil
/**/
kan sträcka sig över flera rader. Du använder denna kommentarstil för att dokumentera ett block med SQL-kod./* Get sales rep employees that reports to Anthony*/SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1143 AND jobTitle = "Sales Rep";
Observera att MySQL inte stöder kapslade kommentarer.
Körbara kommentarer
MySQL tillhandahåller körbara kommentarer för att stödja portabilitet mellan olika databaser. Dessa kommentarer låter dig bädda in SQL-kod som endast körs i MySQL men inte andra databaser.
Följande illustrerar den körbara kommentarsyntaxen:
Code language: SQL (Structured Query Language) (sql)
Till exempel använder följande uttalande en körbar kommentar:
Code language: SQL (Structured Query Language) (sql)
Uttrycket returnerar 2 istället för 1. Det returnerar dock 1 om du kör det i andra databassystem.
Om du vill utföra en kommentar från en specifik version av MySQL använder du följande syntax:
Code language: SQL (Structured Query Language) (sql)