Руководство по созданию эффективных запросов

Долларовые кавычки
В предыдущем разделе мы сказали, что тело функции представлено как 
строковый литерал; однако вместо кавычек он начинается и заканчивает-
ся символами 
$BODY$
. Такая нотация в PostgreSQL называется 
долларовыми
кавычками
, и она особенно полезна при создании функций. Действительно, 
в большом тексте функции, скорее всего, встретятся одинарные кавычки 
или обратная косая черта, и вам придется экранировать их в каждом случае. 
С долларовыми кавычками вы определяете строковый литерал, используя 
два знака доллара, возможно, с некоторым тегом между ними.
Возможность указывать теги делает этот способ определения строковых 
констант особенно удобным, поскольку позволяет вкладывать строки с раз-
ными тегами. Например, начало тела функции может выглядеть, как в лис-
тинге 11.4.

---

196

Функции
Листинг 11.4 

Использование вложенных долларовых кавычек
$function$
DECLARE
v_error_message text := 'Ошибка:';
v_record_id integer;
BEGIN
...
v_error_message := v_error_message ||
$em$Невозможно обновить запись № $em$ || quote_literal(v_record_id);
...
END;
$function$
Здесь для тела функции мы используем долларовые кавычки с тегом 
function
. Обратите внимание, что нет правил, предписывающих для тела 
функции какой-то определенный тег. Можно использовать и пустой; един-
ственное требование – строковый литерал должен заканчиваться тем же 
тегом, с которого он начался. В приведенных здесь примерах будут ис-
пользоваться разные теги как напоминание о том, что они не предопреде-
лены.
Тело функции начинается с предложения 
DECLARE
, которое является необя-
зательным, если переменные не нужны. Ключевое слово 
BEGIN
(без точки с за-
пятой) обозначает начало раздела инструкций, а ключевое слово 
END
должно 
быть последней инструкцией тела функции.
Этот раздел не является исчерпывающим руководством по созданию функций. Более 
подробную информацию можно найти в документации PostgreSQL.
Другие особенности обсуждаются по мере их появления в следующих при-
мерах.