MySQL-快速入门（8）存储过程、存储函数

1、存储过程

1》创建存储过程：create procedure

create procedure sp_name ([in | out | inout] param_name type)

[characteristics ...]  routine_body

characteristics指定存储过程的特性：

1>language sql：说明routine_body部分是由sql语句组成的，当前系统支持的语言为sql，sql是language特性的唯一值。

2>[not] deterministic：指明存储过程执行的结果是否确定。deterministic表示结果是确定的。每次执行存储过程时，相同的输入会得到相同的输出。not deterministic表示结果是不确定的，相同的输入可能得到不同的输出。如果没有指定任意一个值，默认为not deterministic。

3>｛contains sql | no sql | reads sql data | modifies sql data｝：指明子程序使用sql语句的限制。contains sql表明子程序包含sql语句，但是不包含读写数据的语句；no sql表明子程序不包含sql语句；reads sql data说明子程序包含读数据的语句；modifies sql data表明子程序包含写数据的语句。默认情况下，系统会指定为contains sql。

4>sql security{definer | invoker}：指明谁有权限来执行。definer表示只有定义者才能执行。invoker表示拥有权限的调用者可以执行。默认情况下，系统指定为definer。

5>comment 'string'：注释信息，可以用来描述存储过程或函数。

routine_body：sql代码的内容，可以用begin...end;来表示sql代码的开始和结束。

//最简单的存储过程
create procedure p_get_avg()

begin

  ...

end;

//"delimiter //"的作用是将MySQL的结束符设置为//，因为MySQL默认的语句结束符号为分号";"，
//为了避免与存储过程中sql语句的结束符相冲突，需要使用delimiter改变存储过程的结束符，并
//"end//"结束存储过程。"delimiter ;"则是恢复默认的";"结束符。
mysql> delimiter //

mysql> create procedure p_get_avg()

    -> begin

    ->   select * from test;

    -> end//

Query OK, 0 rows affected (0.02 sec)

mysql> delimiter ;

2、存储函数

1》创建存储函数：create function

//指定in、out、inout只对procedure是合法的，在function中总是默认为in类型
//如果return返回的类型不同于returns指定的类型，返回值将会被强制转换为恰当的类型。
create function func_name([in | out | inout] param_name type)

returns type

[characteristic ...] routine_body

mysql> delimiter //

mysql> create function f_get_avg()

    -> returns char(25)

    -> begin

    ->   return (select name from test where id=1);

    -> end//

Query OK, 0 rows affected (0.00 sec)

mysql> delimiter ;

mysql> delimiter //

mysql> drop function if exists f_get_avg;

    -> CREATE FUNCTION f_get_avg()

    -> RETURNS int

    -> begin

    ->   declare i int default 0;

    ->   select 666 into i from dual;

    ->   return i;

    -> end//

Query OK, 0 rows affected (0.02 sec)

Query OK, 0 rows affected (0.02 sec)

mysql> delimiter ;

mysql> select f_get_avg();

+-------------+

| f_get_avg() |

+-------------+

|         666 |

+-------------+

1 row in set (0.00 sec)

mysql>

注：trigger和function都需要写成 select ...into  这种句式，否者会报1415错误？
CREATE DEFINER=`root`@`localhost` FUNCTION `f_get_avg`() RETURNS int(11)

begin

  declare i int default 0;

  /*select 666 into i from dual;*/

  return i;

end

CREATE DEFINER=`root`@`localhost` FUNCTION `f_get_avg`() RETURNS int(11)

begin

  declare i int default 0;

  /*select 666 into i from dual;*/

  set i=999;

  return i;

end

3、变量的使用

1》在存储过程中使用declare语句定义变量：

declare var_name [,var_name]... data_type [default value];
即：
declare var1,var2,var3 int;

2》为变量赋值：定义变量后，MySQL使用set语句为变量赋值

set var_name = expr [,var_name=expr] ...;
或者
select col_name[,...] into var_name[,...] tb_expr;
即：
set var1=10,var2=20;

4、定义条件和处理程序：都是使用declare关键字

1》定义条件

//codition_name：表示条件的名称；condition_type参数表示条件的类型；
//sqlstste_value和mysql_error_code：都可以表示MySQL的错误
//sqlstate_value：为长度为5的字符串类型错误代码。
//mysql_error_code：为数值类型错误代码。
//例如：error 1142(42000)中，sqlstate_value的值是42000，mysql_error_code的值为1142。
declare condition_name condition for [condition_type]

其中[condition_type]:sqlstate [value] sqlstate_value 
                   | mysql_error_code
即：
declare condition_name condition for sqlstate [value] sqlstate_value
或者

declare condition_name condition for mysql_error_code

举例：

//定义"error 1148(42000)"错误，名称为command_not_allowed

//方法一：使用sqlstate_value

declare command_not_allowed condition for sqlstate '';

//方法二：使用mysql_error_code

declare command_not_allowed condition for 1148;

2》定义处理程序

declare handler_type handler for condition_value[，...] sp_statement


sp_statement：程序语句段，表示遇到定义的错误时，需要执行的存储过程或函数

//错误处理方式
//continue：表示遇到错误不处理。继续执行；
//exit：遇到错误马上退出；
//undo：表示遇到错误后撤回之前的操作，MySQL暂时不支持这样的操作。

handler_type:continue | exit | undo


//错误类型
//sqlstate [value] sqlstate_value：包含5个字符的字符串错误值
//condition_name：表示declare condition定义的错误条件名称
//mysql_error_code：匹配数值类型错误代码
//sqlwarning：匹配所有以01开头的sqlstate错误代码
//not found：匹配所有以02开头的sqlstate错误代码
//sqlexception：匹配所有没有被sqlwarning或not found捕获的sqlstate错误代码
condition_value:

  sqlstate [value] sqlstate_value

 | condition_name

 | mysql_error_code

 | not found

 | sqlexception

 | sqlwarning

举例：

//方法一：捕获sqlstate_value

DECLARE CONTINUE HANDLER FOR SQLSTATE '42S02' SET @info='NO_SUCH_TABLE';

//方法二：捕获mysql_error_code

DECLARE CONTINUE HANDLER FOR 1146 SET @info=' NO_SUCH_TABLE ';

//方法三：先定义条件，然后调用

DECLARE  no_such_table  CONDITION  FOR  1146;

DECLARE CONTINUE HANDLER FOR NO_SUCH_TABLE SET @info=' NO_SUCH_TABLE ';

//方法四：使用SQLWARNING

DECLARE EXIT HANDLER FOR SQLWARNING SET @info='ERROR';

//方法五：使用NOT FOUND

DECLARE EXIT HANDLER FOR NOT FOUND SET @info=' NO_SUCH_TABLE ';

//方法六：使用SQLEXCEPTION

DECLARE EXIT HANDLER FOR SQLEXCEPTION SET @info='ERROR';

mysql> DELIMITER //

mysql> CREATE PROCEDURE handlerdemo ()

    ->       BEGIN

    ->        DECLARE CONTINUE HANDLER FOR SQLSTATE '' SET @x2 = 1;

    ->        SET @x = 1;

    ->        INSERT INTO t VALUES (1);

    ->        SET @x = 2;

    ->        INSERT INTO t VALUES (1);

    ->        SET @x = 3;

    ->       END;

    ->      //

Query OK, 0 rows affected (0.02 sec)

mysql> DELIMITER ;

mysql> CALL handlerdemo();

Query OK, 0 rows affected (0.02 sec)

mysql> select @x;

+------+

| @x   |

+------+

|    3 |

+------+

1 row in set (0.00 sec)

mysql> select @x2;

+------+

| @x2  |

+------+

|    1 |

+------+

1 row in set (0.00 sec)

mysql> select * from t;

+----+

| s1 |

+----+

|  1 |

+----+

1 row in set (0.00 sec)

mysql>

@x是一个用户变量，执行结果@x等于3，说明存储过程被执行到了最后面一句。如果省去异常处理那一句，第2个insert因为主键约束强制失败之后，存储过程可能已经采取默认（exit）路径，此时select @x返回的结果可能是2。

"@var_name"表示用户变量，使用set语句为其赋值，用户变量与连接有关，一个客户端定义的变量不能被其他客户端看到或使用。
当客户端连接退出时，该客户端连接的所有变量将自动释放。

5、光标的使用：MySQL中的光标只能在存储过程、存储函数中使用

1》声明光标

declare cursor_name cursor for select_statement;

2》打开关标

open cursor_name;

3》使用光标

fetch cursor_name into var_name[，var_name] ...;

4》关闭光标

close cursor_name;

举个例子：

create procedure p3()

begin

    declare id int;

    declare name varchar(15);

    declare flag int default 0;

    -- 声明游标

    declare mc cursor for select * from class1;

    declare continue handler for not found set flag = 1;

    -- 打开游标

    open mc;

    -- 获取结果

    loop_label_0:loop

      fetch mc into id,name;

      if flag=1 then -- 当无法fetch会触发handler continue

           leave loop_label_0;

      end if;

      -- 这里是为了显示获取结果

      insert into class2 values(id,name);

      -- 关闭游标

    end loop;
    close mc;

end;

call p3();-- 不报错

select * from class2;

6、流程控制使用

MySQL中用于流程控制的语句有：if、case、loop、leave、iterate、repeat、while语句。每个流程可能包含一个单独语句，或者使用begin...end构造的符合语句，构造可以被嵌套。

1》if语句

//statement_list可以包含一个或者多个语句

if expr_condition then 
   statement_list

 [elseif expr_condition then statement_list ...] ...

 [else statement_list]

end if

2》case语句。与“控制流程函数”中的case是不同的。

//第一种方式：

//匹配表达式的值

case case_expr

  when  when_value  then  statement_list

  [when  when_value  then statement_list] ...

  [else statement_list]   //不能有else null子句

end case

//第二种方式：

//逐个表达式执行，直到有一个表达式为true被执行

case

  when expr_condition then statement_list

  [when expr_condition then statement_list] ...

  [else statement_list]   //不能有else null子句

end case

3》loop语句

[loop_label:] loop

   statement_list
   //如果要跳出循环,这时候label是必须的
   if expr_condition then leave loop_label
   end if;

end loop [loop_label]

4》leave语句

//用来退出任何被标注的流程控制构造，包括begin...end和循环体。
leave label

5》iterate语句

//将执行顺序转到语句段开头处
//iterate只可以出现在loop、repeat、while语句内，iterate表示再次循环，label参数表示循环的标志。
//iterate语句必须跟在循环标志前面。

iterate label

CREATE PROCEDURE doiterate()

BEGIN

DECLARE p1 INT DEFAULT 0;

my_loop: LOOP

  SET p1= p1 + 1;

  IF p1 < 10 THEN ITERATE my_loop;

  ELSEIF p1 > 20 THEN LEAVE my_loop;

  END IF;

  SELECT 'p1 is between 10 and 20';

END LOOP my_loop;

END

6》repeat语句

创建一个带条件判断的循环过程，每次语句执行完毕，会对条件表达式进行判断，如果表达式为真，则循环结束；否则重复执行循环中的语句。相当于do...while语句。

[repeat_label:]repeat

  statement_list

until expr_condition

end repeat [repeat_label]

7》while语句

[while_label:]while expr_condition do

   statement_list

end while [while_label]

7、调用存储过程、存储函数

存储过程的调用必须使用call语句，并且存储过程和数据库相关，如果要执行其他数据库中的存储过程，需要指定数据库名称。

存储函数的调用与MySQL中定义的函数的调用方式相同。

1》调用存储过程

call sp_name([parameter[,...]])

CREATE DEFINER=`root`@`localhost` PROCEDURE `p_get_name`(in i_id int,out o_name varchar(25))
begin
select name into o_name from test t where t.id=i_id;
end

-----------------------------------
mysql> call p_get_name(1,@name);

Query OK, 1 row affected (0.00 sec)

mysql> select @name;

+-------+

| @name |

+-------+

| Lucy  |

+-------+

1 row in set (0.00 sec)

mysql>

2》调用存储函数：与MySQL内部定义的函数一样的使用方法。

CREATE DEFINER=`root`@`localhost` FUNCTION `f_get_avg`() RETURNS char(50) CHARSET utf8

begin

  return (select avg(salary) from test);

end

--------------------------------------

mysql> select f_get_avg();

+-------------+

| f_get_avg() |

+-------------+

| 1180        |

+-------------+

1 row in set (0.00 sec)

mysql>

8、查看存储过程和函数，方法有3种：

1》show status

//[like 'pattern']指匹配存储过程或函数的名称
show ｛procedure | function｝ status [like 'pattern']

mysql> show procedure status like 'p_get_name%' \G

*************************** 1. row ***************************

                  Db: mybatis

                Name: p_get_name

                Type: PROCEDURE

             Definer: root@localhost

            Modified: 2019-09-05 00:28:04

             Created: 2019-09-05 00:28:04

       Security_type: DEFINER

             Comment:

character_set_client: utf8

collation_connection: utf8_general_ci

  Database Collation: utf8_general_ci

1 row in set (0.00 sec)

mysql>

2》show create

show create ｛procedure | function｝ sp_name

mysql> show create function f_get_avg \G

*************************** 1. row ***************************

            Function: f_get_avg

            sql_mode: STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITU

TION

     Create Function: CREATE DEFINER=`root`@`localhost` FUNCTION `f_get_avg`() R

ETURNS char(50) CHARSET utf8

begin

  return (select avg(salary) from test);

end

character_set_client: utf8

collation_connection: utf8_general_ci

  Database Collation: utf8_general_ci

1 row in set (0.00 sec)

mysql>

3》从系统的information_schema数据库查询

MySQL中存储过程和存储函数的信息存储在information_schema数据库下的Routines表中。

select * from information_schema.Routines

where routine_name=' sp_name ' and routine_type='procedure | function';

mysql> select * from information_schema.routines where routine_name='p_get_name'

 and routine_type='procedure' \G

*************************** 1. row ***************************

           SPECIFIC_NAME: p_get_name

         ROUTINE_CATALOG: def

          ROUTINE_SCHEMA: mybatis

            ROUTINE_NAME: p_get_name

            ROUTINE_TYPE: PROCEDURE

               DATA_TYPE:

CHARACTER_MAXIMUM_LENGTH: NULL

  CHARACTER_OCTET_LENGTH: NULL

       NUMERIC_PRECISION: NULL

           NUMERIC_SCALE: NULL

      DATETIME_PRECISION: NULL

      CHARACTER_SET_NAME: NULL

          COLLATION_NAME: NULL

          DTD_IDENTIFIER: NULL

            ROUTINE_BODY: SQL

      ROUTINE_DEFINITION: begin

  select name into o_name from test t where t.id=i_id;

end

           EXTERNAL_NAME: NULL

       EXTERNAL_LANGUAGE: NULL

         PARAMETER_STYLE: SQL

        IS_DETERMINISTIC: NO

         SQL_DATA_ACCESS: CONTAINS SQL

                SQL_PATH: NULL

           SECURITY_TYPE: DEFINER

                 CREATED: 2019-09-05 00:28:04

            LAST_ALTERED: 2019-09-05 00:28:04

                SQL_MODE: STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBS

TITUTION

         ROUTINE_COMMENT:

                 DEFINER: root@localhost

    CHARACTER_SET_CLIENT: utf8

    COLLATION_CONNECTION: utf8_general_ci

      DATABASE_COLLATION: utf8_general_ci

1 row in set (0.00 sec)

mysql>

9、修改存储过程、函数（并不是修改其中的代码）

alter {procedure | function} sp_name [characteristic ...]

characteristic指定存储过程的特性，可能的取值有：

  contains sql：表示子程序包含sql语句，但不包含读或写数据的语句。
  no sql：表示子程序中不包含sql语句。
  reads sql data：表示子程序中包含读数据的语句。
  modifies sql data：表示子程序中包含写数据的语句。
  sql security {definer | invoker}：指明谁有权限来执行。
  definer：表示只有定义者自己才能够执行。
  invoker：表示调用者可以执行。
  comment 'string'：表示注释信息。

10、删除存储过程、函数

drop {procedure | function} [if exists] sp_name

巴特西

MySQL-快速入门（8）存储过程、存储函数

最新文章

热门文章