6.1.5 Синтаксис комментариев
Сервер MySQL поддерживает следующие способы задания комментариев: с
помощью символа `#', за которым следует текст комментария до конца строки;
с помощью двух символов --, за которыми идет текст комментария до конца
строки; и (для многострочных комментариев) с помощью символов /* (начало
комментария) и */ (конец комментария):
mysql> SELECT 1+1; # Этот комментарий продолжается до конца строки
mysql> SELECT 1+1; -- Этот комментарий продолжается до конца строки
mysql> SELECT 1 /* Это комментарий в строке */ + 1;
mysql> SELECT 1+
/*
Это многострочный
комментарий
*/
1;
Обратите внимание: при использовании для комментирования способа с --
(двойное тире) требуется наличие хотя бы одного пробела после второго
тире!
Хотя сервер ``понимает'' все описанные выше варианты комментирования,
существует ряд ограничений на способ синтаксического анализа комментариев
вида /* ... */ клиентом mysql:
-
Символы одинарной и двойной кавычек, даже внутри комментария,
считаются началом заключенной в кавычки строки. Если внутри
комментария не встречается вторая такая же кавычка, синтаксический
анализатор не считает комментарий законченным. При работе с
mysql в
интерактивном режиме эта ошибка проявится в том, что окно запроса
изменит свое состояние с mysql> на '> или ">.
-
Точка с запятой используется для обозначения окончания данной
SQL-команды и что-либо, следующее за этим символом, указывает на
начало следующего выражения.
Эти ограничения относятся как к интерактивному режиму работы mysql (из
командной строки), так и к вызову команд из файла, читаемого с ввода
командой mysql < some-file.
MySQL поддерживает принятый в ANSI SQL способ комментирования с помощью
двойного тире `--' только в том случае, если после второго тире следует
пробел (see section 1.9.4.7 Символы `--' как начало комментария).
