Categories: PostgreSQL

PostgreSQL | Как выводить в консоль промежуточные результаты работы функции?

Как сделать подобие console.log() как в JavaScript?

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

Нужный нам оператор (команда) называется:

RAISE NOTICE

Команда RAISE предназначена для вывода сообщений и вызова ошибок. Она может быть написана в коротком виде.

Но в нашей задаче нужно дополнительно указывать УРОВЕНЬ.

УРОВЕНЬ задаёт уровень важности ошибки. Возможные значения: DEBUG, LOG, INFO, NOTICE, WARNING и EXCEPTION. По умолчанию используется EXCEPTION.

 

Давайте напишем самую простую функцию:

— Использование RAISE NOTICE

— в теле функции

 

CREATE OR REPLACE FUNCTION rn()

RETURNS void

LANGUAGE ‘plpgsql’

AS

$$

DECLARE

myvar bigint := 0;

BEGIN

RAISE NOTICE ‘myvar = %’, myvar;

END;

$$;

 

— Вызов функции

 

SELECT rn();

 

— Удаление функции

 

DROP FUNCTION rn();

 

Как работает функция?

Наша простейшая функция написана на языке plpgsql.

Она ничего не принимает. Входных параметров нет.

Она ничего не возвращает. Ключевое слово RETURNS использует для этого значение void.

Теперь давайте вызовем нашу функцию и посмотрим на консольные сообщения.

Делать вызов мы будем в веб-интерфейсе pgAdmin 4.

Вывели в консоль промежуточный результат работы функции в PostgreSQL при помощи RAISE NOTICE

 

На вкладке «Messages» можно рассмотреть пункт «ЗАМЕЧАНИЕ:«. Справа от этой записи мы увидим нашу строку, где вместо знака процента будет стоять наше число ноль. Мы вывели именно то, что хотели узнать в процессе работы функции.

Чуть ниже мы также видим информационное сообщение, которое говорит нам о том, что  вызов выполнился УСПЕШНО.

 

Дополнение

Давайте добавим в нашу функцию немножко логики и каждый этап буем выводить в консоль.

CREATE OR REPLACE FUNCTION rn2()

RETURNS void

LANGUAGE ‘plpgsql’

AS

$$

DECLARE

myvar bigint := 0;

BEGIN

myvar := myvar + 1; RAISE NOTICE ‘%’, myvar;

myvar := myvar + 2; RAISE NOTICE ‘%’, myvar;

myvar := myvar + 3; RAISE NOTICE ‘%’, myvar;

myvar := myvar + 4; RAISE NOTICE ‘%’, myvar;

END;

$$;

 

Результат работы функции:

Данные не выходят из функции в PostgreSQL при помощи void

В выходных данных мы ничего не получаем так как фактически функция ничего не возвращает из-за void. Нам так нужно. Иначе если не использовать void, то нужно что-то возвращать да ещё с каким-то конкретным типом данных.

А вот вкладка «Messages» становится более насыщенной.

Четыре команды RAISE NOTICE в теле функции в PostgreSQL информируют о работе функции в консоли Messages

В этот раз мы видим уже 4 замечания и 4 значения. Каждая операция корректно складывает числа и увеличивает значение переменной myvar на

 

Информационные ссылки

Официальный сайт WEB-оболочки pgAdmin — https://www.pgadmin.org

Официальный сайт СУБД PostgreSQL — https://www.postgresql.org

Раздел «43.9. Сообщения и ошибки» — https://postgrespro.ru/docs/postgresql/14/plpgsql-errors-and-messages

 

admin

Share
Published by
admin

Recent Posts

PostgreSQL | Как получить первый элемент из ячейки типа record?

При помощи функции "row()" мы можем создавать записи - данные с типом record. -- Создаём…

1 год ago

PostgreSQL | Как отфильтровать JSONB-массив объектов по логическому значению ключа?

-- массив JSONB с объектами select '[{"id":1, "q":true}, {"id":2, "q":false}, {"id":3, "q":true}, {"id":4, "q":false}]'::jsonb; --…

1 год ago

PostgreSQL | Как отбросить нули в типе numeric?

Функция "trim_scale()" умеет отбрасывать лишние нули в числах с типом numeric. select trim_scale(37.000000000); -- 37…

1 год ago

JavaScript | Как получить следующий день?

Следующий день относительно текущего т. е. "завтра" var tomorrow = new Date(); tomorrow.setDate(tomorrow.getDate() + 1);…

1 год ago

PostgreSQL | Агрегация JSONB-объектов в один объект

У нас есть столбец из JSONB объектов. Нам нужно соединить все объекты этого столбца в…

1 год ago

PostgreSQL | Группировка по 10 записей

Не всегда нужно группировать записи таблиц в рамках какого-то повторяющегося значения столбца. Иногда нужно просто…

1 год ago