Starlark Procedure Error Reporting¶
在 Starlark 存储过程中,失败的
mo.sql()调用返回的错误值仍然可以打印和拼接为消息字符串,此外还携带 MySQL 错误号与 SQLSTATE。用mo.errno()与mo.sqlstate()读取它们,即可按错误类别而非匹配消息文本来分支。
描述¶
当 mo.sql() 在 Starlark 存储过程中失败时,它的第二个返回值是一个错误值。该值保留原有行为——它仍像普通消息字符串一样打印与拼接——并且现在还携带两个错误码:
mo.errno()返回 MySQL 错误号(例如重复条目的1062)。mo.sqlstate()返回 SQLSTATE(例如完整性约束类的23000)。
成功时 mo.sql() 的错误返回值为 None,因此不会填充错误码。后续的成功调用会清除记录,mo.errno() 永远不会报告过期的错误类别。
语法¶
mo.errno()
mo.sqlstate()
这两个内置函数均不接受参数,需在 Starlark 存储过程中、mo.sql() 调用之后使用。
参数¶
这两个内置函数不接受任何参数,各自返回最近一次失败 mo.sql() 调用记录的错误码:
函数 |
返回值 |
|---|---|
|
最近一次失败 |
|
最近一次失败 |
示例¶
DROP DATABASE IF EXISTS starlark_err_demo;
CREATE DATABASE starlark_err_demo;
USE starlark_err_demo;
CREATE TABLE t (a INT PRIMARY KEY, b VARCHAR(10));
INSERT INTO t VALUES (1, 'one');
CREATE TABLE plog (id INT, note VARCHAR(300));
CREATE OR REPLACE PROCEDURE sp_err() LANGUAGE 'starlark'
$$
rs, err = mo.sql("insert into t values (1, 'dup')")
code = -1 if err == None else mo.errno()
state = "none" if err == None else mo.sqlstate()
mo.sql("insert into plog values (1, 'code={} sqlstate={}')".format(code, state))
$$;
CALL sp_err();
SELECT id, note FROM plog ORDER BY id;
DROP DATABASE starlark_err_demo;
使用说明¶
错误值仍是可打印的字符串;
len(err)、切片、startswith(...)与字符串格式化继续可用。将错误值赋给
OUT参数时仍然传递消息字符串,与引入错误码之前一致。成功时错误为
None;应仅从错误值推导错误码,而不要依赖过期记录。