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参数作为位置参数给出。为了向后兼容,也可以给出多个位置参数。在这种情况下,这些位置参数所构成元组的字符串表示会成为报告给客户端的消息。
可接受以下仅限关键字的参数:
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 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 41.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)))
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。