CALL 语句
1. CALL sp_name([parameter[,...]])
1. CALL sp_name[()]
CALL 语句调用 CREATE PROCEDURE 定义的存储过程。
如果存储过程不带参数,调用时可以在不带括号。也就是说,CALL p() 和 CALL p 是等价的。
CALL 可以使用声明为 OUT 或 INOUT 的参数将值回传给它的调用者。当过程返回时,客户端程序还可以获得例程中执行的最后一条语句所影响的行数: 在 SQL 级别,调用 ROW_COUNT() 函数;在 C API 中,调用 mysql_affected_rows() 函数。
要使用 OUT 或 INOUT 参数从过程中获取值,请通过用户变量传递该参数,然后在过程返回后检查变量的值。(如果从另一个存储过程或函数中调用该过程,还可以将例程参数或本地例程变量作为 IN 或 INOUT 参数传递。)对于 INOUT 参数,请在将其传递给过程之前对其值进行初始化。下面的过程有一个 OUT 参数,该过程将其设置为当前服务器版本,以及一个 INOUT 值,该过程将其当前值递增 1:
1. CREATE PROCEDURE p (OUT ver_param VARCHAR(25), INOUT incr_param INT)
2. BEGIN
3. # Set value of OUT parameter
4. SELECT VERSION() INTO ver_param;
5. # Increment value of INOUT parameter
6. SET incr_param = incr_param + 1;
7. END;
在调用过程之前,初始化作为 INOUT 参数传递的变量。调用过程后,两个变量的值将被设置或修改:
1. mysql> SET @increment = 10;
2. mysql> CALL p(@version, @increment);
3. mysql> SELECT @version, @increment;
4. +--------------------+------------+
5. | @version | @increment |
6. +--------------------+------------+
7. | 8.0.3-rc-debug-log | 11 |
8. +--------------------+------------+
在用于 PREPARE 和 EXECUTE 的预编译 CALL 语句中,占位符可以用于 IN 参数、OUT 和 INOUT 参数。这些类型的参数可以使用如下:
1. mysql> SET @increment = 10;
2. mysql> PREPARE s FROM 'CALL p(?, ?)';
3. mysql> EXECUTE s USING @version, @increment;
4. mysql> SELECT @version, @increment;
5. +--------------------+------------+
6. | @version | @increment |
7. +--------------------+------------+
8. | 8.0.3-rc-debug-log | 11 |
9. +--------------------+------------+
要编写使用 CALL SQL 语句执行产生结果集的存储过程的 C 程序,必须启用 CLIENT_MULTI_RESULTS 标志。这是因为除了过程中执行的语句可能返回的结果集之外,每个 CALL 还返回一个结果来指示调用状态。如果使用 CALL 执行任何包含预编译语句的存储过程,也必须启用 CLIENT_MULTI_RESULTS。在加载过程中不能确定这些语句是否会产生结果集,因此有必要假定它们会产生结果集。
可以在调用 mysql_real_connect() 时显式地传递 CLIENT_MULTI_RESULTS 标志本身,或者隐式传递CLIENT_MULTI_STATEMENTS 来启用 CLIENT_MULTI_RESULTS。默认情况下 CLIENT_MULTI_RESULTS 是启用的。
要处理使用 mysql_query() 或 mysql_real_query() 执行的 CALL 语句的结果,可以使用一个调用 mysql_next_result() 的循环来确定是否有更多的结果。
C 程序可以使用预编译语句接口来执行 CALL 语句并访问 OUT 和 INOUT 参数。这是通过使用循环处理 CALL 语句的结果来完成的,该循环调用 mysql_stmt_next_result() 来确定是否有更多的结果。提供 MySQL 接口的语言可以使用预编译的 CALL 语句直接检索 OUT 和 INOUT 过程参数。
存储程序引用的对象的元数据更改将被检测到,并在下次执行程序时自动重新解析受影响的语句。