Комментарии Комментарием называется фрагмент обычного текста, оформленный специальным образом и внедренный в код SQL. Комментарии не влияют на выполнение программы, поскольку PostgreSQL удаляет их из входного потока и интерпретирует как обычные пропуски. Существует две разновидности комментариев: однострочные и многострочные. Однострочные комментарии начинаются с двух дефисов (- -) и либо находятся в отдельной строке, либо следуют за лексемами SQL (модуль лексического разбора PostgreSQL не считает комментарии лексемами, а все символы, следующие за последовательностью --, интерпретирует как пропуски). Пример однострочного комментария приведен в листинге 3.11. Листинг 3.11. Однострочные комментарии testdb=# SELECT 'Test1 -- This can follow valid SQL tokens. testdb-# -- or be on a line of its own. testdb-# AS example; example Test (1 row) Многострочные комментарии начинаются с последовательности /* и завершаются последовательностью */. Такой способ оформления комментариев хорошо знаком программистам С, но между интерпретатором PostgreSQL и компилятором С существует одно принципиальное отличие: комментарии PostgreSQL могут быть вложенными. Иначе говоря, если внутри многострочного комментария имеется другой многострочный комментарий, то закрывающая последовательность */ внутреннего комментария не закрывает внешний комментарий. Пример многострочного комментария приведен в листинге 3.12. Листинг 3.12. Многострочные комментарии testdb=# SELECT 'Multi /* This comment extends across testdb-# * numerous lines, and can be testdb-# * /* nested safely */ */ testdb-# | '-test' AS example; example Multi-test (1 row) Допустим, имеется файл с кодом SQL, в котором необходимо закомментировать большой фрагмент и передать остаток PostgreSQL для интерпретации и выполнения. Если в этом фрагменте встречаются многострочные комментарии, PostgreSQL правильно заключает, что закрывающая последовательность */ относится к последнему открытому комментарию, а не ко всему закомментированному блоку. ПРИМЕЧАНИЕ Звездочка (без смежного символа косой черты) не имеет особой интерпретации в комментариях. Дополнительные звездочки были включены в листинг 3.12 исключительно по эстетическим сообщениям. Выводы Итак, команда SQL состоит из отдельных лексем, каждая из которых может быть ключевым словом, идентификатором, защищенным идентификатором, константой или специальным символом. В табл. 3.7 структура команд SQL поясняется на примере простой команды SELECT. Таблица 3.7. Простой запрос SQL   SELECT id, name FROM states Тип лексемы Ключевое слово Идентификаторы Ключевое слово Идентификатор Описание Команда Имена полей Имя секции Имя таблицы Как видно из таблицы, команда SELECT содержит ключевые слова SELECT и FROM. Ключевое слово FROM с лексемой states образует секцию, уточняющую смысл команды SELECT. Лексемы id, name и states в приведенном примере являются идентификаторами. Идентификаторы Id и name определяют выбираемые поля, а идентификатор states определяет имя таблицы, из которой производится выборка. Таким образом, приведенный выше запрос приказывает PostgreSQL выбрать поля Id и name каждой записи таблицы states. В листинге 3.13 показаны результаты выполнения этого запроса. Листинг 3.13. Пример запроса SQL booktown=# SELECT Id, name FROM states; id | name 42 | Washington 51 I Oregon (2 rows) booktown=# В табл. 3.8 и 3.9 анализируется другая, более сложная команда SQL. В ней используется действие UPDATE с секциями SET и WHERE, которые определяют соответственно правило изменения записей и критерий их отбора. Таблица 3.8. Команда UPDATE с секцией SET UPDATE states SET id = 51 Ключевое слово Идентификатор Ключевое слово Идентификатор Оператор Целочисленная константа Команда Имя таблицы Имя секции Имя поля Присваивание Новое значение поля id Таблица 3.9. Секция WHERE WHERE name = 'Oregon' Ключевое слово Идентификатор Оператор Строковая константа Имя секции Имя поля Проверка эквивалентности Искомое значение Приведенная команда просматривает содержимое поля name каждой записи и проверяет, совпадает ли оно с условием секции WHERE (совпадение со строковой константой ' Oregon'). Затем во всех записях, соответствующих этому условию, полю id присваивается значение 51. Итак, рассмотренная команда UPDATE содержит три ключевых слова, три идентификатора и две константы. Ключевыми словами являются лексемы UPDATE (выполняемое действие), SET (правило обновления записей) и WHERE (критерий отбора обновляемых записей). Оба оператора представлены знаком =. В секции SET этот знак используется для присваивания (то есть обновления поля существующей записи) — применение, специфическое для секции SET. С другой стороны, в секции WHERE оператор = используется для сравнения двух значений. В данном примере поле name записи сравнивается со строковой константой Oregon. Наконец, в примере присутствует целочисленная константа 51 (новое значение поля id) и строковая константа Oregon (сравниваемая с полем name в секции WHERE). Таким образом, команда UPDATE, приведенная в листинге 3.14, обновляет таблицу states, присваивая значение 51 полю Id всех записей, у которых поле name содержит значение Oregon. Результат проверяется следующей командой SELECT. Листинг 3.14. Обновление таблицы командой UPDATE booktown=# UPDATE states booktown-# SET id = 51 booktown-# WHERE name = 'Oregon'; UPDATE 1 booktown=# SELECT * FROM states booktown-$ WHERE name='Oregon': Id | name | abbreviation 51 | Oregon | OR (1 row) booktown=#