MySQL存储例程与光标

MySQL存储例程与光标

一. MySQL存储例程

实际包含了存储过程和存储函数，它们被统称为存储例程。

其中存储过程主要完成在获取记录或插入记录或更新记录或删除记录，即完成select insert delete update等的工作。而存储函数只完成查询的工作，可接受输入参数并返回一个结果。

二. MySQL存储过程

存储过程概念

SQL语句需要先编译然后执行，而存储过程（Stored Procedure）是一组为了完成特定功能的SQL语句集，经编译后存储在数据库中，用户通过指定存储过程的名字并给定参数（如果该存储过程带有参数）来调用执行它。

存储过程是可编程的函数，在数据库中创建并保存，可以由SQL语句和控制结构组成。当想要在不同的应用程序或平台上执行相同的函数，或者封装特定功能时，存储过程是非常有用的。数据库中的存储过程可以看做是对编程中面向对象方法的模拟，它允许控制数据的访问方式。

存储过程优点

1. 增强SQL语言的功能和灵活性：存储过程可以用控制语句编写，有很强的灵活性，可以完成复杂的判断和较复杂的运算。
2. 标准组件式编程：存储过程被创建后，可以在程序中被多次调用，而不必重新编写该存储过程的SQL语句。而且数据库专业人员可以随时对存储过程进行修改，对应用程序源代码毫无影响。
3. 较快的执行速度：如果某一操作包含大量的Transaction-SQL代码或分别被多次执行，那么存储过程要比批处理的执行速度快很多。因为存储过程是预编译的。在首次运行一个存储过程时查询，优化器对其进行分析优化，并且给出最终被存储在系统表中的执行计划。而批处理的Transaction-SQL语句在每次运行时都要进行编译和优化，速度相对要慢一些。
4. 减少网络流量：针对同一个数据库对象的操作（如查询、修改），如果这一操作所涉及的Transaction-SQL语句被组织进存储过程，那么当在客户计算机上调用该存储过程时，网络中传送的只是该调用语句，从而大大减少网络流量并降低了网络负载。
5. 作为一种安全机制来充分利用：通过对执行某一存储过程的权限进行限制，能够实现对相应的数据的访问权限的限制，避免了非授权用户对数据的访问，保证了数据的安全。

存储过程创建过程

命令格式

CREATE PROCEDURE  过程名([[IN|OUT|INOUT] 参数名 数据类型[,[IN|OUT|INOUT] 参数名 数据类型…]]) [特性 ...] 过程体

示例

DELIMITER //
  CREATE PROCEDURE myproc(OUT s int)
    BEGIN
    SELECT COUNT(*) INTO s FROM students;
    END
    //
DELIMITER ;

“DELIMITER //”与”DELIMITER ;”：
MySQL默认以”;”为分隔符，如果没有声明分割符，则编译器会把存储过程当成SQL语句进行处理，因此编译过程会报错，所以要事先用“DELIMITER //”声明当前段分隔符，让编译器把两个”//”之间的内容当做存储过程的代码，不会执行这些代码；“DELIMITER ;”的意为把分隔符还原。

参数：
存储过程根据需要可能会有输入、输出、输入输出参数，如果有多个参数用”,”分割开。MySQL存储过程的参数用在存储过程的定义，共有三种参数类型,IN,OUT,INOUT：

• IN：参数的值必须在调用存储过程时指定，在存储过程中修改该参数的值不能被返回，为默认值
• OUT：该值可在存储过程内部被改变，并可返回
• INOUT:调用时指定，并且可被改变和返回

过程体：
过程体的开始与结束使用BEGIN与END进行标识。

IN参数例子：

创建存储过程
DELIMITER //
  CREATE PROCEDURE in_param(IN p_in INT)
    BEGIN
    SELECT p_in;
    SET p_in=2;
    SELECT p_in;
    END;
    //
DELIMITER ;
调用存储过程
SET @p_in = 3; 定义参数值
select @p_in; 此时结果为3

call in_param(@p_in); 调用存储过程(3,2)
select @p_in; 结果依旧是3，p_in虽然在存储过程中被修改，但并不影响@p_id的值

ON参数例子：

创建存储过程
DELIMITER //
  CREATE PROCEDURE out_param(OUT p_out INT)
    BEGIN
    SELECT p_out;
    SET p_out = 2;
    SELECT p_out;
    END;
    //
DELIMITER ;
调用存储过程
SET @p_out = 3; 定义参数值
select @p_out; 此时结果为3

call out_param(@p_out); 调用存储过程(null,2)，out是向调用者输出参数，不接收输入的参数，所以存储过程里的p_out为null
select @p_out; 结果是2，p_out在存储过程中被修改是有用的

INOUT参数例子(不建议使用)：

创建存储过程
DELIMITER //
  CREATE PROCEDURE inout_param(INOUT p_inout INT)
    BEGIN
    SELECT p_inout;
    SET p_inout=2;
    SELECT p_inout;
    END;
    //
    DELIMITER ;
调用存储过程
SET @p_inout=1; 定义参数值
SELECT @p_inout; 此时结果是1

CALL inout_param(@p_inout) ; 调用存储过程(1,2)
SELECT @p_inout; 结果是2，@p_inout可被改变和返回

存储过程体

存储过程体包含了在过程调用时必须执行的语句，例如：dml、ddl语句，if-then-else和while-do语句、声明变量的declare语句等

过程体格式：以begin开始，以end结束(可嵌套)

存储过程调用

用call和你过程名以及一个括号，括号里面根据需要，加入参数，参数包括输入参数、输出参数、输入输出参数。

MySQL存储过程的查询

查询存储过程

SHOW PROCEDURE STATUS WHERE db='数据库名';

查看存储过程详细信息

SHOW CREATE PROCEDURE 数据库.存储过程名;

MySQL存储过程的删除

DROP PROCEDURE [过程1[,过程2…]]
从MySQL的表格中删除一个或多个存储过程。

存储过程中注释

MySQL存储过程可使用两种风格的注释：

• 双模杠(–)：该风格一般用于单行注释
• c风格： 一般用于多行注释

MySQL存储过程的修改

ALTER PROCEDURE 更改用CREATE PROCEDURE 建立的预先指定的存储过程，其不会影响相关存储过程或存储功能。

命令格式：

ALTER {PROCEDURE | FUNCTION} sp_name [characteristic ...]
characteristic:
{ CONTAINS SQL | NO SQL | READS SQL DATA | MODIFIES SQL DATA }
| SQL SECURITY { DEFINER | INVOKER }
| COMMENT 'string'

sp_name：参数表示存储过程或函数的名称；
characteristic：参数指定存储函数的特性。
CONTAINS SQL：表示子程序包含SQL语句，但不包含读或写数据的语句；
NO SQL：表示子程序中不包含SQL语句；
READS SQL DATA：表示子程序中包含读数据的语句；
MODIFIES SQL DATA：表示子程序中包含写数据的语句。
SQL SECURITY { DEFINER | INVOKER }：指明谁有权限来执行，DEFINER表示只有定义者自己才能够执行；INVOKER表示调用者可以执行。
COMMENT ‘string’：是注释信息。

使用示例：

#将读写权限改为MODIFIES SQL DATA，并指明调用者可以执行。
ALTER  PROCEDURE  num_from_employee
  MODIFIES SQL DATA
  SQL SECURITY INVOKER ;
#将读写权限改为READS SQL DATA，并加上注释信息'FIND NAME'。
ALTER  PROCEDURE  name_from_employee
  READS SQL DATA
  COMMENT 'FIND NAME' ;

MySQL存储过程的控制语句

变量作用域：内部变量在其作用域范围内享有更高的优先权，当执行到end时，内部变量消失，不再可见了，在存储过程外再也找不到这个内部变量，但是可以通过out参数或者将其值指派给会话变量来保存其值。

变量作用域示例：

创建存储过程
DELIMITER //
  CREATE PROCEDURE proc()
    BEGIN
      DECLARE x1 VARCHAR(5) DEFAULT 'outer';
        BEGIN
          DECLARE x1 VARCHAR(5) DEFAULT 'inner';
          SELECT x1;
        END;
      SELECT x1;
    END;
    //
DELIMITER ;
#调用
CALL proc();

条件语句
IF-THEN-ELSE语句

DROP PROCEDURE IF EXISTS proc3;
DELIMITER //
CREATE PROCEDURE proc3(IN parameter int)
  BEGIN
    DECLARE var int;
    SET var=parameter+1;
    IF var=0 THEN
      INSERT INTO t VALUES (17);
    END IF ;
    IF parameter=0 THEN
      UPDATE t SET s1=s1+1;
    ELSE
      UPDATE t SET s1=s1+2;
    END IF ;
  END ;
  //
DELIMITER ;

CASE-WHEN-THEN-ELSE语句

DELIMITER //
CREATE PROCEDURE proc4 (IN parameter INT)
  BEGIN
    DECLARE var INT;
    SET var=parameter+1;
    CASE var
      WHEN 0 THEN
        INSERT INTO t VALUES (17);
      WHEN 1 THEN
        INSERT INTO t VALUES (18);
      ELSE
        INSERT INTO t VALUES (19);
    END CASE ;
  END ;
  //
DELIMITER ;

循环语句
WHILE-DO…END-WHILE

DELIMITER //
  CREATE PROCEDURE proc5()
    BEGIN
      DECLARE var INT;
      SET var=0;
      WHILE var<6 DO
        INSERT INTO t VALUES (var);
        SET var=var+1;
      END WHILE ;
    END;
    //
DELIMITER ;

REPEAT…END REPEAT(此语句的特点是执行操作后检查结果)

DELIMITER //
  CREATE PROCEDURE proc6 ()
    BEGIN
      DECLARE v INT;
      SET v=0;
      REPEAT
        INSERT INTO t VALUES(v);
        SET v=v+1;
        UNTIL v>=5
      END REPEAT;
    END;
    //
DELIMITER ;

LOOP…END LOOP

DELIMITER //
  CREATE PROCEDURE proc7 ()
    BEGIN
      DECLARE v INT;
      SET v=0;
      LOOP_LABLE:LOOP
        INSERT INTO t VALUES(v);
        SET v=v+1;
        IF v >=5 THEN
          LEAVE LOOP_LABLE;
        END IF;
      END LOOP;
    END;
    //
DELIMITER ;

LABLES标号：标号可以用在begin repeat while 或者loop 语句前，语句标号只能在合法的语句前面使用。可以跳出循环，使运行指令达到复合语句的最后一步。

ITERATE迭代(通过引用复合语句的标号,来从新开始复合语句)

DELIMITER //
  CREATE PROCEDURE proc8()
    BEGIN
      DECLARE v INT;
      SET v=0;
      LOOP_LABLE:LOOP
        IF v=3 THEN
          SET v=v+1;
          ITERATE LOOP_LABLE;
        END IF;
          INSERT INTO t VALUES(v);
          SET v=v+1;
        IF v>=5 THEN
          LEAVE LOOP_LABLE;
        END IF;
      END LOOP;
    END;
    //
DELIMITER ;

三. 存储函数

创建存储函数，需要使用CREATE FUNCTION语句，基本语法如下：

CREATE FUNCTION func_name([func_parameter])
RETURNS TYPE
[characteristics...] routine_body

CREATE FUNCTION为用来创建存储函数的关键字；func_name表示存储函数的名称
func_parameter为存储函数的参数列表，参数列表如下： [IN|OUT|INOUT]PARAM_NAMETYPE
其中，IN表示输入参数，OUT表示输出参数，INOUT表示既可以输入也可以输出；
param_name表示参数名称；type表示参数类型，该类型可以是MYSQL数据库中的任意类型
RETURNS TYPE语句表示函数返回数据的类型；characteristics：指定存储函数的特性，取值与创建存储过程时相同

使用示例：

创建存储函数：
DELIMITER //
  CREATE FUNCTION NameByT()
    RETURNS CHAR(50)
    READS SQL DATA
    RETURN (SELECT user_name FROM test WHERE id = 19); 
  //
DELIMITER ;
使用存储函数：
SELECT NameByT();
查询存储函数
SHOW FUNCTION STATUS WHERE db = 'test';
删除存储函数
DROP FUNCTION IF EXISTS NameByT;

四. 定义条件和处理程序

特定条件需要特定处理。这些条件可以联系到错误，以及子程序中的一般流程控制。定义条件是事先定义程序执行过程中遇到的问题，处理程序定义了在遇到这些问题时候应当采取的处理方式，并且保证存储过程或函数在遇到警告或错误时能继续执行。

这样可以增强存储程序处理问题的能力，避免程序异常停止运行。

定义条件

命令格式：

DECLARE condition_name CONDITION FOR[condition_type]
[condition_type]:
SQLSTATE[VALUE] sqlstate_value |mysql_error_code

condition_name：表示条件名称
condition_type：表示条件的类型
sqlstate_value和mysql_error_code都可以表示mysql错误
sqlstate_value为长度5的字符串错误代码
mysql_error_code为数值类型错误代码，例如：ERROR1142(42000)中，sqlstate_value的值是42000，
mysql_error_code的值是1142

这个语句指定需要特殊处理条件。他将一个名字和指定的错误条件关联起来。这个名字随后被用在定义处理程序的DECLARE HANDLER语句中。

使用示例：

定义ERROR1148(42000)错误，名称为command_not_allowed。
可以用两种方法定义
//方法一：使用sqlstate_value
DECLARE command_not_allowed CONDITION FOR SQLSTATE '42000'
//方法二：使用mysql_error_code
DECLARE command_not_allowed CONDITION FOR SQLSTATE 1148

定义处理程序

MySQL中可以使用DECLARE关键字来定义处理程序。其基本语法如下：

DECLARE handler_type HANDLER FOR 
condition_value[,...] sp_statement 
handler_type: 
CONTINUE | EXIT | UNDO 
condition_value: 
SQLSTATE [VALUE] sqlstate_value |
condition_name | SQLWARNING 
| NOT FOUND | SQLEXCEPTION | mysql_error_code

其中，handler_type参数指明错误的处理方式，该参数有3个取值。这3个取值分别是CONTINUE、EXIT和UNDO。
CONTINUE表示遇到错误不进行处理，继续向下执行；
EXIT表示遇到错误后马上退出；
UNDO表示遇到错误后撤回之前的操作，MySQL中暂时还不支持这种处理方式。
注意：通常情况下，执行过程中遇到错误应该立刻停止执行下面的语句，并且撤回前面的操作。
但是，MySQL中现在还不能支持UNDO操作。
因此，遇到错误时最好执行EXIT操作。如果事先能够预测错误类型，并且进行相应的处理，那么可以执行CONTINUE操作。
condition_value参数指明错误类型，该参数有6个取值。
sqlstate_value和mysql_error_code与条件定义中的是同一个意思。
condition_name是DECLARE定义的条件名称。
SQLWARNING表示所有以01开头的sqlstate_value值。
NOT FOUND表示所有以02开头的sqlstate_value值。
SQLEXCEPTION表示所有没有被SQLWARNING或NOT FOUND捕获的sqlstate_value值。
sp_statement表示一些存储过程或函数的执行语句。

下面是定义处理程序的几种方式。代码如下：

//方法一：捕获sqlstate_value 
DECLARE CONTINUE HANDLER FOR SQLSTATE '42000'
SET @info='CAN NOT FIND'; 
//方法二：捕获mysql_error_code 
DECLARE CONTINUE HANDLER FOR 1148SET @info='CAN NOT FIND'; 
//方法三：先定义条件，然后调用 
DECLARE can_not_find CONDITION FOR 1146 ; 
DECLARE CONTINUE HANDLER FOR can_not_find SET 
@info='CAN NOT FIND'; 
//方法四：使用SQLWARNING 
DECLARE EXIT HANDLER FOR SQLWARNING SET @info='ERROR'; 
//方法五：使用NOT FOUND 
DECLARE EXIT HANDLER FOR NOT FOUND SET @info='CAN NOT FIND'; 
//方法六：使用SQLEXCEPTION 
DECLARE EXIT HANDLER FOR SQLEXCEPTION SET @info='ERROR';

上述代码是6种定义处理程序的方法。
第一种方法是捕获sqlstate_value值。如果遇到sqlstate_value值为42000，执行CONTINUE操作，并且输出”CAN NOT FIND”信息。
第二种方法是捕获mysql_error_code值。如果遇到mysql_error_code值为1148，执行CONTINUE操作，并且输出”CAN NOT FIND”信息。
第三种方法是先定义条件，然后再调用条件。这里先定义can_not_find条件，遇到1148错误就执行CONTINUE操作。
第四种方法是使用SQLWARNING。SQLWARNING捕获所有以01开头的sqlstate_value值，然后执行EXIT操作，并且输出”ERROR”信息。
第五种方法是使用NOT FOUND。NOT FOUND捕获所有以02开头的sqlstate_value值，然后执行EXIT操作，并且输出”CAN NOT FIND”信息。
第六种方法是使用SQLEXCEPTION。SQLEXCEPTION捕获所有没有被SQLWARNING或NOT FOUND捕获的sqlstate_value值，然后执行EXIT操作，并且输出”ERROR”信息。

定义条件和处理程序

示例：

CREATE TABLE t8(s1 INT,PRIMARY KEY(s1))

DELIMITER //
  CREATE PROCEDURE handlerdemo()
    BEGIN
      DECLARE CONTINUE HANDLER FOR SQLSTATE '23000' SET @X2=1;
      SET @X=1;
      INSERT INTO t8 VALUES(1);
      SET @X=2;
      INSERT INTO t8 VALUES(1);
      SET @X=3;
    END;
    //
DELIMITER ;

/* 调用存储过程*/
CALL handlerdemo();

/* 查看调用存储过程结果*/
SELECT @X  #结果为3

五. 光标(游标)

MYSQL里叫光标，SQLSERVER里叫游标，实际上一样的。查询语句可能查询出多条记录，在存储过程和函数中使用光标来逐条读取查询结果集中的记录。

光标的使用包括声明光标、打开光标、使用光标和关闭光标。光标必须声明在处理程序之前，并且声明在变量和条件之后。

声明光标

MySQL中使用DECLARE关键字来声明光标。其语法的基本形式如下：

DECLARE cursor_name CURSOR FOR select_statement ;

其中，cursor_name参数表示光标的名称；select_statement参数表示SELECT语句的内容，返回一个用于创建光标的结果集。

示例：

下面声明一个名为cur_employee的光标。代码如下：
DECLARE cur_employee CURSOR FOR SELECT name, age FROM employee ;

上面的示例中，光标的名称为cur_employee；SELECT语句部分是从employee表中查询出name和age字段的值。

打开光标

MySQL中使用OPEN关键字来打开光标。其语法的基本形式如下：

OPEN  cursor_name ;

其中，cursor_name参数表示光标的名称。

下面打开一个名为cur_employee的光标，代码如下：

OPEN  cur_employee ;

使用光标

MySQL中使用FETCH关键字来使用光标。其语法的基本形式如下：

FETCH cur_employee INTO var_name[,var_name…] ; 

其中，cursor_name参数表示光标的名称；var_name参数表示将光标中的SELECT语句查询出来的信息存入该参数中。var_name必须在声明光标之前就定义好。

下面使用一个名为cur_employee的光标。将查询出来的数据存入emp_name和emp_age这两个变量中，代码如下：

FETCH  cur_employee INTO emp_name, emp_age ; 

上面的示例中，将光标cur_employee中SELECT语句查询出来的信息存入emp_name和emp_age中。emp_name和emp_age必须在前面已经定义。

关闭光标

MySQL中使用CLOSE关键字来关闭光标。其语法的基本形式如下：

CLOSE  cursor_name ; 

其中，cursor_name参数表示光标的名称。

下面关闭一个名为cur_employee的光标。代码如下：

CLOSE  cur_employee ; 

上面的示例中，关闭了这个名称为cur_employee的光标。关闭之后就不能使用FETCH来使用光标了。

注意：MYSQL中，光标只能在存储过程和函数中使用！！

删除光标

declear cursor_name

使用光标示例

下面是一个存储过程，里面用到游标，逐条更新数据（批量更新数据）

BEGIN
 DECLARE  no_more_record INT DEFAULT 0;
 DECLARE  pID BIGINT(20);
 DECLARE  pValue DECIMAL(15,5);
 DECLARE  cur_record CURSOR FOR   SELECT colA, colB from tableABC;  /*首先这里对游标进行定义*/
 DECLARE  CONTINUE HANDLER FOR NOT FOUND  SET  no_more_record = 1; /*这个是个条件处理,针对NOT FOUND的条件,当没有记录时赋值为1*/

 OPEN  cur_record; /*接着使用OPEN打开游标*/
 FETCH  cur_record INTO pID, pValue; /*把第一行数据写入变量中,游标也随之指向了记录的第一行*/

 WHILE no_more_record != 1 DO
 INSERT  INTO testTable(ID, Value)
 VALUES  (pID, pValue);
 FETCH  cur_record INTO pID, pValue; /*从第二行数据写入变量中,游标也随之指向了记录的第二行，依次循环，直到游标所指向的行无数据*/

 END WHILE;
 CLOSE  cur_record;  /*用完后记得用CLOSE把资源释放掉*/
END

六. 知识拓展

变量定义

语法：

DECLARE 变量名1[,变量名2...] 数据类型 [默认值];

var_name为局部变量的名称。DEFAULT VALUE子句给变量提供一个默认值。值除了可以被声明为一个常数外，还可以被指定为一个表达式。如果没有DEFAULT子句，初始值为NULL

变量赋值

语法：

SET 变量名 = 变量值 [,变量名= 变量值 ...]

MYSQL中还可以通过SELECT…INTO为一个或多个变量赋值
示例：

DECLARE NAME CHAR(50);
DECLARE id DECIMAL(8,2);
SELECT id,NAME INTO id ,NAME FROM t3 WHERE id=2;

用户变量

用户变量一般以@开头，用户变量是全局变量，

1.在MySQL客户端使用用户变量

SELECT 'Hello World' into @x;
SELECT @x; 结果：Hello World

SET @y='Goodbye Cruel World';
SELECT @y; 结果：Goodbye Cruel World

SET @z=1+2+3;
SELECT @z; 结果：6

2.在存储过程中使用用户变量

创建存储过程
DELIMITER //
  CREATE PROCEDURE greet_world()
    BEGIN
    SELECT CONCAT(@greeting,' World');
    END;
    //
DELIMITER ;
调用存储过程
SET @greeting = 'Hello';
CALL greet_world(); 结果：CONCAT(@greeting,' World')值为Hello World

3.在存储过程间传递全局范围的用户变量

存储过程核心代码
p1(): SET @last_proc='p1';
p2(): SELECT CONCAT('Last procedure was ',@last_proc);
调用存储过程
call p1();
call p2(); 结果：CONCAT('Last procedure was ',@last_proc)值为Last procedure was  p1

注意：滥用用户变量会导致程序难以理解及管理

参考文献

MySQL存储过程 https://www.cnblogs.com/mark-chan/p/5384139.html
自定义存储过程和函数 https://www.cnblogs.com/lyhabc/p/3793524.html