Переменные
Аргументы
При вызове функции PL/pgSQL могут получать аргументы различных типов. В аргументах пользователь передает исходные данные, необходимые для работы функции. Аргументы делают функции PL/pgSQL более универсальными и значительно расширяют область их возможного применения. Список аргументов приводится после имени функции в круглых скобках и разделяется запятыми.
Количество и типы аргументов должны соответствовать первоначальному определению функции. В листинге 11.21 приведены примеры двух вызовов функции из клиента psql.
Листинг 11.21. Примеры вызовов функций.
booktown=# SELECT get_author('John');
get_author
John Worsley
(1 row)
booktown=# SELECT
get_author(1111);
get_author
Ariel Denham
(1 row)
Примечание
Функции get_author(text) и get_author(integer) будут рассмотрены позднее в этой главе.
Аргументы, полученные функцией, поочередно присваиваются идентификаторам, состоящим из знака доллара ($) и порядкового номера. Первому аргументу соответствует идентификатор $1, второму – $2 и т. д. Максимальное количество аргументов равно 16, поэтому идентификаторы аргументов лежат в интервале от $1 до $16. В листинге 11.22 приведен пример функции, которая удваивает свой целочисленный аргумент.
Листинг 11.22. Непосредственное использование аргументов в переменных.
CREATE FUNCTION double_price (float) RETURNS float AS ' DECLARE BEGIN --Вернуть значение аргумента, умноженное на 2. return $1 * 2: END: ' LANGUAGE 'plpgsql';
Если функция имеет большое количество аргументов, в обозначениях вида "$+номер" легко запутаться. Чтобы программисту было проще отличить одни аргумент от другого (или если он хочет присвоить переменной аргумента более содержательное имя), в PL/pgSQL предусмотрена возможность определения псевдонимов переменных.
Псевдоним создается при помощи ключевого слова ALIAS и представляет собой альтернативный идентификатор для ссылки на аргумент. Перед использованием все псевдонимы (как и обычные переменные) должны быть объявлены в секции объявлений блока. В листинге 11.23 показан синтаксис применения ключевого слова ALIAS.
Листинг 11.23. Синтаксис использования ключевого слова ALIAS.
CREATE FUNCTION функция (аргументы) RETURNS тип AS ' DECLARE идентификатор ALIAS FOR $1: идентификатор ALIAS FOR $2: BEGIN END.:" ' LANGUAGE 'plpgsql':
В листинге 11.24 приведен простой пример, демонстрирующий применение псевдонимов в функциях PL/pgSQL. Функция triplе_рriсе() получает вещественное число, умножает его на три и возвращает результат.
Листинг 11.24. Псевдонимы PL/pgSQL.
CREATE FUNCTION triple_pnce (float) RETURNS float AS ' DECLARE --Переменная input_price объявляется как псевдоним --для переменной аргумента, обычно обозначаемой --идентификатором $1 .input_price ALIAS FOR $1: BEGIN – Вернуть аргумент, умноженный на три. RETURN input_price * 3: END: ' LANGUAGE 'plpgsql':
Если теперь вызвать функцию triple_pnce() при выполнении команды SQL SELECT в клиенте psql, будет получен результат, показанный в листинге 11.25.
Листинг 11.25. Результат вызова функции triple_price().
booktown=# SELECT triple_price(12.50); triple_price 37.5 (1 row)