plpy
模块也提供了函数
plpy.debug( |
plpy.log( |
plpy.info( |
plpy.notice( |
plpy.warning( |
plpy.error( |
plpy.fatal( |
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配置变量控制。详见Chapter 19。
msg
参数被给定位一个位置参数。为了向后兼容,可以给出多于一个位置参数。在那种情况下, 位置参数形成的元组的字符串表达将会变成报告给客户端的消息。
下列 keyword-only 参数会被接受:
detail |
hint |
sqlstate |
schema_name |
table_name |
column_name |
datatype_name |
constraint_name |
作为 keyword-only 参数传递的对象的字符串表达可以用来丰富报告给客户端的消息。例如:
CREATE FUNCTION raise_custom_exception() RETURNS void AS $$ plpy.error("custom exception message", detail="some info about exception", hint="hint for users") $$ LANGUAGE plpythonu; =# 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 <module> hint="hint for users") PL/Python function "raise_custom_exception"
另一组工具函数是plpy.quote_literal(
、string
)plpy.quote_nullable(
以及string
)plpy.quote_ident(
。它们等效于Section 9.4中描述的内建引用函数。在构建临时查询时它们能派上用场。Example 43.1中动态 SQL 的 PL/Python 等效体是:
string
)
plpy.execute("UPDATE tbl SET %s = %s WHERE key = %s" % ( plpy.quote_ident(colname), plpy.quote_nullable(newvalue), plpy.quote_literal(keyvalue)))