Код PL/pgSQL функции указывается в CREATE FUNCTION в виде строкового литерала. Если строковый литерал записывается обычным способом в одинарных кавычках, то все одинарные кавычки внутри тела функции должны быть удвоены; также должны быть удвоены все обратные косые черты (при условии использования синтаксиса escape-строк). Удвоение кавычек в лучшем случае утомительно, а в более сложных случаях код может стать совершенно непонятным, так как может потребоваться использование шести или более кавычек подряд. Вместо этого рекомендуется записывать тело функции в виде «экранированная долларами,» представляет собой строковый литерал (см. Раздел 2.1.1.2.4). При использовании экранирования долларами никогда не требуется удваивать кавычки; вместо этого следует выбирать различные разделители для каждого необходимого уровня вложенности. Например, команду CREATE FUNCTION можно записать следующим образом:

CREATE OR REPLACE FUNCTION testfunc(integer) RETURNS integer AS $PROC$
          ....
$PROC$ LANGUAGE plpgsql;

При этом кавычки можно использовать для простых строковых литералов в командах SQL и $$ для разграничения фрагментов команд SQL, собираемых в виде строк. Если необходимо заключить в кавычки текст, который содержит $$, можно использовать $Q$, и так далее.

В следующей таблице показано, какие действия необходимо выполнить при написании кавычек без использования экранирования долларами. Данная возможность может быть полезна при преобразовании кода, написанного без использования экранирования долларами, в более понятный вид.

Для помощи в поиске простых, но распространенных проблем до того, как они приведут к ошибкам, PL/pgSQL предоставляет дополнительные проверки. Если они включены, то в зависимости от конфигурации их можно использовать для вывода либо сообщения WARNING либо сообщения ERROR во время компиляции функции. Функция, получившая параметр a WARNING может быть выполнена без вывода последующих сообщений, поэтому рекомендуется проводить тестирование в отдельной среде разработки.

Установка параметров plpgsql.extra_warnings, или plpgsql.extra_errors, в зависимости от необходимости, в значение "all" рекомендуется в средах разработки и тестирования.

Данные дополнительные проверки включаются с помощью переменных конфигурации plpgsql.extra_warnings для предупреждений и plpgsql.extra_errors для ошибок. Для обоих параметров можно установить значение в виде списка проверок через запятую, "none" или "all". Значение по умолчанию — "none". В настоящее время список доступных проверок включает:

В следующем примере показан результат установки параметра plpgsql.extra_warnings в значение shadowed_variables:

SET plpgsql.extra_warnings TO 'shadowed_variables';

CREATE FUNCTION foo(f1 int) RETURNS int AS $$
DECLARE
f1 int;
BEGIN
RETURN f1;
END;
$$ LANGUAGE plpgsql;
WARNING:  variable "f1" shadows a previously defined variable
LINE 3: f1 int;
        ^
CREATE FUNCTION

В приведенном ниже примере показаны последствия установки значения plpgsql.extra_warnings в strict_multi_assignment:

SET plpgsql.extra_warnings TO 'strict_multi_assignment';

CREATE OR REPLACE FUNCTION public.foo()
 RETURNS void
 LANGUAGE plpgsql
AS $$
DECLARE
  x int;
  y int;
BEGIN
  SELECT 1 INTO x, y;
  SELECT 1, 2 INTO x, y;
  SELECT 1, 2, 3 INTO x, y;
END;
$$;

SELECT foo();
WARNING:  number of source and target fields in assignment does not match
DETAIL:  strict_multi_assignment check of extra_warnings is active.
HINT:  Make sure the query returns the exact list of columns.
WARNING:  number of source and target fields in assignment does not match
DETAIL:  strict_multi_assignment check of extra_warnings is active.
HINT:  Make sure the query returns the exact list of columns.

 foo
-----

(1 row)