CREATE PROCEDURE / CALL / DROP PROCEDURE

MatrixOne v4.2.5 支持 SQL 和 Starlark 两类存储过程。它们是数据库中的具名程序,通过 CALL 调用;与 Python UDF、触发器、SQL Task 是不同的能力。

语法

CREATE [OR REPLACE] PROCEDURE [database_name.]procedure_name (
    [ [IN | OUT | INOUT] parameter_name parameter_type [, ...] ]
) [LANGUAGE 'sql' | LANGUAGE 'starlark'] 'procedure_body';
CALL [database_name.]procedure_name([argument [, ...]]);
DROP PROCEDURE [IF EXISTS] [database_name.]procedure_name;
SHOW PROCEDURE STATUS [LIKE 'pattern' | WHERE condition];

省略 LANGUAGE 时使用 SQL。过程体必须是字符串;SQL 过程通常把 BEGIN ... END 写在该字符串内。内部字符串中的单引号应写成两个单引号,例如 ''done''。原样提交 MySQL 的 CREATE PROCEDURE p() BEGIN ... END 在 v4.2.5 会产生语法错误。

IN 为输入参数;OUT 为输出参数;INOUT 为输入输出参数。调用时用会话变量(如 @result)承接 OUT、INOUT,并在同一连接读取。OR REPLACE 替换同名过程,DROP ... IF EXISTS 可用于清理。

SQL 过程

SQL 过程支持局部变量 DECLARE、赋值 SET、条件分支和循环。以下独立示例验证 IN、OUT、INOUT、WHILE 和 IF:

CREATE DATABASE mo_procedure_lab;
USE mo_procedure_lab;
CREATE PROCEDURE sum_to(IN n INT, OUT total INT, INOUT acc INT)
'begin DECLARE i INT DEFAULT 1; SET total = 0; WHILE i <= n DO SET total = total + i; SET i = i + 1; END WHILE; IF total > 0 THEN SET acc = acc + total; END IF; end';
SET @acc = 10;
CALL sum_to(3, @total, @acc);
-- Expected-Values: 6, 16
SELECT @total AS total, @acc AS acc;
DROP PROCEDURE sum_to;
DROP DATABASE mo_procedure_lab;

预期 total=6、acc=16。更多业务写入和失败回滚实验见存储过程教程。

Starlark 过程

Starlark 是独立语言,并非 Python UDF。参数名成为输入变量,输出写入 out_<参数名>。保留换行和缩进,使用驱动把完整 CREATE PROCEDURE 作为一个请求提交。

CREATE DATABASE mo_starlark_lab;
USE mo_starlark_lab;
CREATE OR REPLACE PROCEDURE twice(IN i INT, OUT o INT)
LANGUAGE 'starlark' '
out_o = i + i
';
CALL twice(7, @o);
-- Expected-Value: 14
SELECT @o AS result;
DROP PROCEDURE twice;
DROP DATABASE mo_starlark_lab;

结果为 14。Starlark 可以通过 mo.sql() 执行 SQL,返回结果和错误;失败时错误为字符串,可用 mo.errno()、mo.sqlstate() 读取错误码与 SQLSTATE。应用必须处理错误返回值,不能假设返回错误就自动停止整个程序。详见Starlark SQL 错误报告。

迁移与运维边界

  • v4.2.5 实测 SHOW PROCEDURE STATUS 可枚举过程;SHOW CREATE PROCEDURE 会产生语法错误。不要以它作为导出过程定义的方式,应在版本管理中保留创建脚本。

  • 同一次实测中 information_schema.ROUTINES 未列出已创建的过程;不能据此判断数据库中没有存储过程。

  • 驱动调用 CALL 后应按驱动接口消费全部结果集,再复用连接。DELIMITER 是 MySQL 客户端命令,不能发送给服务端或驱动。

  • 本页的示例不构成对 MySQL 游标、异常处理器、递归、权限模型或所有过程选项的完整兼容承诺;迁移时逐项验证实际业务脚本。

  • SQL 过程的 DML 失败回滚实验见教程;该结果不能推广为所有 DDL、显式事务、Starlark 错误处理或 Task 多语句体的原子性保证。

本页示例与上述边界于 2026-10-14 使用 8.0.30-MatrixOne-v4.2.5 单 CN 实例验证。