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 过程参数。

存储程序引用的对象的元数据更改将被检测到，并在下次执行程序时自动重新解析受影响的语句。