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() 调用记录的错误码:

函数

返回值

mo.errno()

最近一次失败 mo.sql() 调用的 MySQL 错误号(例如 1062);最近一次调用成功时为 0。

mo.sqlstate()

最近一次失败 mo.sql() 调用的 SQLSTATE(例如 23000);最近一次调用成功时为空字符串。

示例

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;应仅从错误值推导错误码,而不要依赖过期记录。