Как писать комментарии в SQL?

Да, комментарии в SQL есть, и они бывают двух видов — как в большинстве языков. На выполнение запроса они никак не влияют: парсер их просто игнорирует.

Однострочный комментарий — два дефиса --, всё до конца строки игнорируется:

SELECT id, name
FROM users        -- берём только активных
WHERE active = true;

Многострочный комментарий — /* ... */, может занимать несколько строк:

/*
  Отчёт по заказам за месяц.
  Автор: Иван, обновлено 2026-06.
  Осторожно: тяжёлый запрос, не гонять на проде в часы пик.
*/
SELECT customer_id, SUM(total)
FROM orders
GROUP BY customer_id;

Эти два синтаксиса работают во всех основных СУБД — PostgreSQL, MySQL, SQLite, SQL Server.

Где комментарии особенно полезны:

• пояснить зачем нужен хитрый JOIN или подзапрос (не что делает строка, а почему она тут);
• временно «выключить» кусок запроса, не удаляя его;
• оставить заметку о производительности или о граблях.

Пара нюансов, о которых стоит знать:

• В MySQL есть третий вид однострочного комментария — # до конца строки. Это нестандартно, в других СУБД не сработает, лучше держитесь --.
• В некоторых консольных клиентах и инструментах миграций строки вида /*! ... */ (MySQL) или --+ трактуются как директивы-подсказки оптимизатору, а не как обычный комментарий. На практике редко мешает, но если увидите странное поведение — вот вероятная причина.

Итог: для коротких пометок — --, для блоков и шапок запросов — /* ... */. Комментируйте «почему», а не «что» — будущий вы скажет спасибо.