ДОКУМЕНТАЦИЯ

Выберите версию, форк и язык для СУБД Digital Q.DataBase, чтобы прочитать или скачать всю документацию.

Новости

01.09.2026

СУБД Digital Q.DataBase можно развернуть из готового Docker-образа

25.08.2026

СУБД Digital Q.DataBase: 8 ядер бесплатно — до 1 сентября!

Документация

Диасофт
Авторские права © 2016–2025 ООО "Диасофт Экосистема"

Скачать всю документацию:

pdf (13 mБ) EPUB (13 mБ) CHM (14 МБ)

5.9.9. Вспомогательные функции

Содержание

Модуль plpy модуль также предоставляет функции

plpy.debug(msg, **kwargs)

plpy.log(msg, **kwargs)

plpy.info(msg, **kwargs)

plpy.notice(msg, **kwargs)

plpy.warning(msg, **kwargs)

plpy.error(msg, **kwargs)

plpy.fatal(msg, **kwargs)

plpy.error и plpy.fatal фактически вызывают исключение Python, которое, если оно не перехвачено, передается в вызывающий запрос, что приводит к отмене текущей транзакции или подтранзакции. raise plpy.Error(msg) и raise plpy.Fatal(msg) эквивалентны вызову plpy.error(msg) и plpy.fatal(msg)соответственно, однако форма raise не позволяет передавать именованные аргументы. Остальные функции лишь генерируют сообщения различных уровней важности. Будут ли сообщения определенного уровня выводиться клиенту, записываться в журнал сервера или и то, и другое, определяется log_min_messages и client_min_messages конфигурационными переменными. См. Глава 3.4 для получения дополнительной информации.

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

Принимаются следующие именованные аргументы (keyword-only):

detail

hint

sqlstate

schema_name

table_name

column_name

datatype_name

constraint_name

Строковое представление объектов, переданных в качестве именованных аргументов, используется для дополнения сообщений, передаваемых клиенту. Например:

CREATE FUNCTION raise_custom_exception() RETURNS void AS $$
plpy.error("custom exception message",
           detail="some info about exception",
           hint="hint for users")
$$ LANGUAGE plpython3u;

=# SELECT raise_custom_exception();
ERROR:  plpy.Error: custom exception message
DETAIL:  some info about exception
HINT:  hint for users
CONTEXT:  Traceback (most recent call last):
  PL/Python function "raise_custom_exception", line 4, in 
    hint="hint for users")
PL/Python function "raise_custom_exception"

Еще одним набором вспомогательных функций являются plpy.quote_literal(строка), plpy.quote_nullable(строка), и plpy.quote_ident(строка). Они эквивалентны встроенным функциям экранирования, описанным в Раздел 2.6.4. Они полезны при формировании произвольных запросов. Аналогом динамического SQL из раздела ... на языке PL/Python Пример 5.6.1 будет:

plpy.execute("UPDATE tbl SET %s = %s WHERE key = %s" % (
    plpy.quote_ident(colname),
    plpy.quote_nullable(newvalue),
    plpy.quote_literal(keyvalue)))

Наверх