Комментарии
📖 Описание
Знаете ли вы, что вы можете поместить комментарии в операторы SQL в Oracle? Комментарии могут появляться в одной строке или распределяться по нескольким строкам. Давайте посмотрим, как это сделать.
🧩 Синтаксис
Есть два синтаксиса, которые можно использовать, чтобы создать комментарий в пределах ваших SQL предложений в Oracle/PLSQL.
🧩 Синтаксис использования символов --
Синтаксис для создания SQL комментариев в Oracle, используя символы --:
-- здесь пишется комментарий
Однострочный комментарий начинается с -- и продолжается до конца строки. Он может занимать отдельную строку или следовать за SQL-кодом. Следующий оператор следует размещать после перевода строки.
🧩 Синтаксис использование символов /* и */
Синтаксис для создания комментария SQL в Oracle с использованием символов /* и */:
/* здесь пишется комментарий */
В Oracle, комментарий, который начинается с символов /* и заканчивается */ может располагаться между элементами SQL-оператора. Этот метод комментирования может занимать несколько строк в пределах вашего SQL.
💻 Учебные данные
Все шесть вариантов ниже используют одну таблицу с тремя занятиями. В учебной схеме с CREATE TABLE и квотой подготовьте:
CREATE TABLE demo_comment_sessions (
session_id NUMBER PRIMARY KEY,
session_title VARCHAR2(60 CHAR) NOT NULL,
event_date DATE NOT NULL
);
INSERT ALL
INTO demo_comment_sessions VALUES (31, 'Paper Lantern', DATE '2026-12-05')
INTO demo_comment_sessions VALUES (32, 'Wood Pattern', DATE '2026-12-12')
INTO demo_comment_sessions VALUES (33, 'Clay Bowl', DATE '2026-12-19')
SELECT 1 FROM dual;
COMMIT;
Каждый последующий COUNT(session_id) возвращает 3: первичный ключ не допускает NULL. Обычные комментарии не меняют этот результат.
💻 Пример комментария на одной строке
Вы можете создать SQL комментарий на одной строке в SQL предложении в Oracle/PLSQL.
Рассмотрим пример SQL комментария, который показывает SQL комментарий на одной строке:
SELECT count(demo_comment_sessions.session_id)
/* количество занятий */
FROM demo_comment_sessions;
Этот SQL комментарий, появляется в середине строки:
SELECT /* количество занятий */ count(demo_comment_sessions.session_id)
FROM demo_comment_sessions;
Этот SQL комментарий, появляется в конце строки:
SELECT count(demo_comment_sessions.session_id) /* количество занятий */
FROM demo_comment_sessions;
или
SELECT count(demo_comment_sessions.session_id) -- количество занятий
FROM demo_comment_sessions;
💻 Пример комментария на нескольких строках
В Oracle, вы можете создать SQL комментарий, который охватывает несколько строк в вашем SQL предложении.
📌 Например:
SELECT count(demo_comment_sessions.session_id)
/*
* количество занятий
* комментарий охватывает несколько строк в вашем SQL предложении.
*/
FROM demo_comment_sessions;
Этот SQL комментарий распространяется на несколько строк в Oracle - в этом примере, он растянут на 4 строки.
В Oracle, вы также можете создать SQL комментарий, который охватывает несколько строк, используя следующий синтаксис:
SELECT count(demo_comment_sessions.session_id) /* количество занятий
комментарий, который охватывает несколько строк в вашем SQL предложении */
FROM demo_comment_sessions;
Oracle/PLSQL будет считать, что все, что после символов /* является комментарием, пока он не достигнет символов */, даже если он охватывает несколько строк внутри SQL предложения. Таким образом, в этом примере, SQL комментарий будет охватывать 2 строки.
Блочные комментарии /* ... */ не вкладываются друг в друга. Таблица demo_comment_sessions с полем session_id подготовлена выше.
📌 Что отличать от обычного комментария
Символы внутри строкового литерала остаются текстом:
SELECT '-- reserved' AS line_text,
'/* draft */' AS block_text
FROM dual;
Результат: -- reserved и /* draft */. Комментарий не позволяет разрывать одно ключевое слово на части. Блочные комментарии не вкладываются; однострочный заканчивается переводом строки, а не точкой с запятой.
Форма /*+ ... */ после ключевого слова оператора может содержать подсказки оптимизатору. Это отдельный механизм. COMMENT ON сохраняет описание объекта в словаре данных; комментарии -- и /* ... */ в тексте SQL этого не делают.