mysql存储过程之参数（IN，OUT或INOUT）的区别和简单示例

在实际应用中，开发的存储过程几乎都需要参数，就是这些参数，使得存储过程更加灵活和有用。 在Mysql中，参数有三种模式：IN，OUT或INOUT：

• IN - 是默认模式。在存储过程中定义IN参数时，调用程序必须将参数传递给存储过程。 另外，IN参数的值被保护。这意味着即使在存储过程中更改了IN参数的值，在存储过程结束后仍保留其原始值。换句话说，存储过程只使用IN参数的副本。
• OUT - 可以在存储过程中更改OUT参数的值，并将其更改后新值传递回调用程序。请注意，存储过程在启动时无法访问OUT参数的初始值。
• INOUT - INOUT参数是IN和OUT参数的组合。这意味着调用程序可以传递参数，并且存储过程可以修改INOUT参数并将新值传递回调用程序。

    我们来看下存储过程中定义参数的语法：

MODE param_name param_type(param_size)

详细说明如下：

• 根据存储过程中参数的目的，MODE可以是IN，OUT或INOUT。
• param_name是参数的名称。参数的名称必须遵循mysql中列名的命名规则。
• 在参数名之后是它的数据类型和大小。和变量一样，参数的数据类型可以是任何有效的mysql数据类型。

    在上面的存储过程中，如果存储过程有多个参数，则每个参数由逗号(,)分隔。

一、我们先来看in模式中，使用GetOfficeByCountry存储过程中的IN参数来查询选择位于特定国家/地区的办公室的实例：

USE `你的数据库名称`;
DROP procedure IF EXISTS `GetOfficeByCountry`;
 
DELIMITER $$
USE `数据库名称`$$
CREATE PROCEDURE GetOfficeByCountry(IN countryName VARCHAR(255))
 BEGIN
 SELECT * 
 FROM offices
 WHERE country = countryName;
 END$$
 
DELIMITER ;

在上面的sql中，countryName是存储过程的IN参数。在存储过程中，我们查询位于countryName参数指定的国家/地区的所有办公室。假设我们想要查询在美国(USA)的所有办事处，我们只需要将一个值(USA)传递给存储过程，如下所示：

CALL GetOfficeByCountry("USA");

   执行上面查询语句，得到以下结果：

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

CALL GetOfficeByCountry("France")

二、out模式中，通过订单状态返回订单数量。它有两个参数：

• orderStatus：IN参数，它是要对订单计数的订单状态。
• total：存储指定订单状态的订单数量的OUT参数。

    然后来看下CountOrderByStatus存储过程的源代码：

USE `你的数据库名称`;
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

 三、再来看下inout模式：

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

上面的sql运行原理如下：

• 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

下面提供几个简单示例：

1.参数in的使用(代表输入，意思说你的参数要传到存过过程的过程里面去)

功能：求1-n的和

//为了避免存储过程中分号(";")结束语句，我们使用分隔符告诉mysql解释器,该段命令是否已经结束了

DELIMITER $$

DROP PROCEDURE IF EXISTS `p1` $$

CREATE PROCEDURE p1 (IN n INT) 
BEGIN
  DECLARE total INT DEFAULT 0 ;DECLARE num INT DEFAULT 0 ;
  WHILE
    num < n DO SET num = num + 1 ;SET total = total + num ;
  END WHILE ;
  SELECT 
    total ;
END $$
DELIMITER ; 
  

调用：

CALL p1(10);

-- 显示结果
55

2.参数out的使用(代表往外输出)
//这里还要注意一点的就是我们的输出参数一定要设置相应类型的初始，否则不管你怎么计算得出的结果都为NULL值

功能：求1-n的和

DELIMITER $$

DROP PROCEDURE IF EXISTS `p2` $$

CREATE PROCEDURE p2 (IN n INT, OUT total INT) 
BEGIN
  DECLARE num INT DEFAULT 0 ;SET total := 0 ;
  WHILE
    num < n DO SET num = num + 1 ;SET total = total + num ;
  END WHILE ;
END $$ 
DELIMITER ;
  

调用：

CALL p2(10,@sum);
SELECT @sum;

--显示结果
55

注意：对于第一个输入参数我们可以理解，但是第二个输出参数我们到底应该怎么输？
这里我们需要对第二个参数定义一个变量名(更形象点就是你输入一个输入类型的参数n，由输出参数total往外发射输出我们只需要定义一个变量名来接收这个输出值即可)

总结in、out区别：
in:表示输入一个值，你需要一个值，我给你一个值
out:你往外输出一个值，你输出的那个值我就拿一个变量来接收你给我输出的那个值

3.参数inout的使用(既能输入一个值又能传出来一个值)

功能：传一个年龄，自动让年龄增长10岁

DELIMITER $$

DROP PROCEDURE IF EXISTS `p3` $$

CREATE PROCEDURE p3 (INOUT age INT) 
BEGIN
  SET age = age + 10 ;
END $$

DELIMITER ;

调用：

SET @currentAge = 8 ;
CALL p3 (@currentAge) ;
SELECT @currentAge;

-- 结果
18

注意：调用的时候，我这里需要和大家声明一下，inout型的参数值既是输入类型又是输出类型，你给它一个值，值不是变量，不是变量那out的时候它怎么赋给这个值是不是？
因此我们需要先设置一个变量并初始化这个值，调用的时候直接传这个变量即可。