Комментарии

📖 Описание

Знаете ли вы, что вы можете поместить комментарии в операторы 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 этого не делают.

См. документацию Oracle: Comments.