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 配置变量控制。有关更多信息,请参见 第 19 章。
msg
参数作为位置参数给出。为了向后兼容,可以给出多个位置参数。在这种情况下,位置参数元组的字符串表示将成为报告给客户端的消息。
以下仅限关键字的参数被接受
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 <module> hint="hint for users") PL/Python function "raise_custom_exception"
另一组实用函数是 plpy.quote_literal(
、string
)plpy.quote_nullable(
和 string
)plpy.quote_ident(
。它们等效于 第 9.4 节 中描述的内置引用函数。它们在构造临时查询时很有用。PL/Python 等效于来自 示例 41.1 的动态 SQL 将是string
)
plpy.execute("UPDATE tbl SET %s = %s WHERE key = %s" % ( plpy.quote_ident(colname), plpy.quote_nullable(newvalue), plpy.quote_literal(keyvalue)))
如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符,或者需要进一步说明,请使用 此表格 报告文档问题。