参数

在本教程中,您将学习如何编写具有参数的MySQL存储过程。还将通过几个存储过程示例来了解不同类型的参数。

MySQL存储过程参数简介

在现实应用中,开发的存储过程几乎都需要参数。这些参数使存储过程更加灵活和有用。 在MySQL中,参数有三种模式:INOUTINOUT

  • IN - 是默认模式。在存储过程中定义IN参数时,调用程序必须将参数传递给存储过程。 另外,IN参数的值被保护。这意味着即使在存储过程中更改了IN参数的值,在存储过程结束后仍保留其原始值。换句话说,存储过程只使用IN参数的副本。

  • OUT - 可以在存储过程中更改OUT参数的值,并将其更改后新值传递回调用程序。请注意,存储过程在启动时无法访问OUT参数的初始值。

  • INOUT - INOUT参数是INOUT参数的组合。这意味着调用程序可以传递参数,并且存储过程可以修改INOUT参数并将新值传递回调用程序。

在存储过程中定义参数的语法如下:

MODE param_name param_type(param_size)

上面语法说明如下 -

  • 根据存储过程中参数的目的,MODE可以是INOUTINOUT

  • param_name是参数的名称。参数的名称必须遵循MySQL中列名的命名规则。

  • 在参数名之后是它的数据类型和大小。和变量一样,参数的数据类型可以是任何有效的MySQL数据类型

如果存储过程有多个参数,则每个参数由逗号(,)分隔。

让我们练习一些例子来更好的理解。 我们将使用示例数据库(yiibaidb)中的表进行演示。

MySQL存储过程参数示例

1.IN参数示例

以下示例说明如何使用GetOfficeByCountry存储过程中的IN参数来查询选择位于特定国家/地区的办公室。

USE `yiibaidb`;
DROP procedure IF EXISTS `GetOfficeByCountry`;

DELIMITER $$
USE `yiibaidb`$$
CREATE PROCEDURE GetOfficeByCountry(IN countryName VARCHAR(255))
 BEGIN
 SELECT * 
 FROM offices
 WHERE country = countryName;
 END$$

DELIMITER ;

countryName是存储过程的IN参数。在存储过程中,我们查询位于countryName参数指定的国家/地区的所有办公室。

假设我们想要查询在美国(USA)的所有办事处,我们只需要将一个值(USA)传递给存储过程,如下所示:

CALL GetOfficeByCountry('USA');

执行上面查询语句,得到以下结果 -

要在法国获得所有办事处,我们将France字符串传递给GetOfficeByCountry存储过程,如下所示:

CALL GetOfficeByCountry('France')

2.OUT参数示例

以下存储过程通过订单状态返回订单数量。它有两个参数:

  • orderStatusIN参数,它是要对订单计数的订单状态。

  • total:存储指定订单状态的订单数量的OUT参数。

以下是CountOrderByStatus存储过程的源代码。

USE `yiibaidb`;
DROP procedure IF EXISTS `CountOrderByStatus`;

DELIMITER $$
CREATE PROCEDURE CountOrderByStatus(
 IN orderStatus VARCHAR(25),
 OUT total INT)
BEGIN
 SELECT count(orderNumber)
 INTO total
 FROM orders
 WHERE status = orderStatus;
END$$
DELIMITER ;

要获取发货订单的数量,我们调用CountOrderByStatus存储过程,并将订单状态传递为已发货,并传递参数(@total)以获取返回值。

CALL CountOrderByStatus('Shipped',@total);
SELECT @total;

执行上面查询语句后,得到以下结果 -

+--------+
| @total |
+--------+
|    303 |
+--------+
1 row in set

要获取正在处理的订单数量,调用CountOrderByStatus存储过程,如下所示:

执行上面查询语句后,得到以下结果 -

+------------------+
| total_in_process |
+------------------+
|                7 |
+------------------+
1 row in set

INOUT参数示例

以下示例演示如何在存储过程中使用INOUT参数。如下查询语句 -

DELIMITER $$
CREATE PROCEDURE set_counter(INOUT count INT(4),IN inc INT(4))
BEGIN
 SET count = count + inc;
END$$
DELIMITER ;

上面查询语句是如何运行的?

  • set_counter存储过程接受一个INOUT参数(count)和一个IN参数(inc)。

  • 在存储过程中,通过inc参数的值增加计数器(count)。

下面来看看如何调用set_counter存储过程:

SET @counter = 1;
CALL set_counter(@counter,1); -- 2
CALL set_counter(@counter,1); -- 3
CALL set_counter(@counter,5); -- 8
SELECT @counter; -- 8

在本教程中,我们向您展示了如何在存储过程中定义参数,并介绍了不同的参数模式:INOUTINOUT

Last updated