43.9. Вспомогательные функции
Модуль plpy также предоставляет функции plpy.debug(, сообщение)plpy.log(, сообщение)plpy.info(, сообщение)plpy.notice(, сообщение)plpy.warning(, сообщение)plpy.error( и сообщение)plpy.fatal(. Функции сообщение)plpy.error и plpy.fatal на самом деле выдают исключение Python, которое, если его не перехватить, распространяется в вызывающий запрос, что приводит к прерыванию текущей транзакции или подтранзакции. Команды raise plpy.Error( и сообщение)raise plpy.Fatal( равнозначны вызовам сообщение)plpy.error и plpy.fatal, соответственно. Остальные функции просто выдают сообщения разных уровней важности. Будут ли сообщения определённого уровня передаваться клиентам и/или записываться в журнал, определяется конфигурационными параметрами log_min_messages и client_min_messages. За дополнительными сведениями обратитесь к Главе 18.
Ещё один набор вспомогательных функций образуют plpy.quote_literal(, строка)plpy.quote_nullable( и строка)plpy.quote_ident(. Они равнозначны встроенным функциям заключения в кавычки, описанным в Разделе 9.4. Они полезны при конструировании свободно составляемых запросов. На PL/Python динамический SQL, показанный в Примере 40.1, формируется так: строка)
plpy.execute("UPDATE tbl SET %s = %s WHERE key = %s" % (
plpy.quote_ident(colname),
plpy.quote_nullable(newvalue),
plpy.quote_literal(keyvalue)))43.9. Utility Functions
The plpy module also provides the functions plpy.debug(, msg)plpy.log(, msg)plpy.info(, msg)plpy.notice(, msg)plpy.warning(, msg)plpy.error(, and msg)plpy.fatal(. msg)plpy.error and plpy.fatal actually raise a Python exception which, if uncaught, propagates out to the calling query, causing the current transaction or subtransaction to be aborted. raise plpy.Error( and msg)raise plpy.Fatal( are equivalent to calling msg)plpy.error and plpy.fatal, respectively. The other functions only generate messages of different priority levels. Whether messages of a particular priority are reported to the client, written to the server log, or both is controlled by the log_min_messages and client_min_messages configuration variables. See Chapter 18 for more information.
Another set of utility functions are plpy.quote_literal(, string)plpy.quote_nullable(, and string)plpy.quote_ident(. They are equivalent to the built-in quoting functions described in Section 9.4. They are useful when constructing ad-hoc queries. A PL/Python equivalent of dynamic SQL from Example 40.1 would be: string)
plpy.execute("UPDATE tbl SET %s = %s WHERE key = %s" % (
plpy.quote_ident(colname),
plpy.quote_nullable(newvalue),
plpy.quote_literal(keyvalue)))