Podsumowanie: w tym samouczku dowiesz się, jak używać komentarza MySQL do dokumentowania instrukcji SQL lub bloku kodu w MySQL.
Komentarze mogą służyć do udokumentowania celu instrukcja SQL lub logika bloku kodu w procedurze składowanej. Podczas analizowania kodu SQL MySQL ignoruje część komentarza. Wykonuje tylko część SQL z wyjątkiem wykonywalnego komentarza, który omówimy w następnej sekcji.
MySQL obsługuje trzy style komentarzy:
- From a
"-- "
do końca wiersza. Styl komentarza z dwoma myślnikami wymaga co najmniej spacji lub znaku kontrolnego (spacji, tabulacji, nowej linii itp.) Po drugim myślniku.SELECT * FROM users; -- This is a comment
Zwróć uwagę, że standardowy SQL nie wymaga spacja po drugiej kresce. MySQL używa białych znaków, aby uniknąć problemów z niektórymi konstrukcjami SQL, takimi jak:
SELECT 10--1;
Instrukcja zwraca 11. Jeśli MySQL nie użyłby białych znaków, zamiast tego zwróć 10.
- Od
"#"
do końca wiersza.SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1002; # get subordinates of Diane
- Komentarz w stylu C
/**/
może obejmować wiele wierszy. Używasz tego stylu komentarza do dokumentowania bloku kodu SQL./* Get sales rep employees that reports to Anthony*/SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1143 AND jobTitle = "Sales Rep";
Zauważ, że MySQL nie obsługuje zagnieżdżonych komentarzy.
Komentarze do plików wykonywalnych
MySQL udostępnia komentarze do plików wykonywalnych, które umożliwiają przenoszenie między różnymi bazami danych. Te komentarze pozwalają na osadzenie kodu SQL, który będzie wykonywany tylko w MySQL, ale nie w innych bazach danych.
Poniższy przykład ilustruje wykonywalną składnię komentarzy:
Code language: SQL (Structured Query Language) (sql)
Na przykład poniższa instrukcja używa wykonywalnego komentarza:
Code language: SQL (Structured Query Language) (sql)
Instrukcja zwraca 2 zamiast 1. Jednak zwróci 1, jeśli wykonasz to w innych systemach baz danych.
Jeśli chcesz wykonać komentarz z określonej wersji MySQL, użyj następującej składni:
Code language: SQL (Structured Query Language) (sql)