其实就是告诉mysql解释器,该段命令是否已经结束了,mysql数据库是否可以执行了。默认情况下,delimiter是分号;。在命令行客户端中,如果有一行命令以分号结束,那么回车后,mysql将会执行该命令。如输入下面的语句
mysql> select * from test_table;
然后回车,那么mysql将立即执行该语句。
但有时候,不希望mysql这么做。在为可能输入较多的语句,且语句中包含有分号。如试图在命令行客户端中输入如下语句
mysql> create function `shorten`(s varchar(255), n int) mysql> returns varchar(255) mysql> begin mysql> if isnull(s) then mysql> return ''; mysql> elseif nmysql> return left(s, n); mysql> else mysql> if char_length(s) mysql> return s; mysql> else mysql> return concat(left(s, n-10), '...', right(s, 5)); mysql> end if; mysql> end if; mysql> end;
默认情况下,不可能等到用户把这些语句全部输入完之后,再执行整段语句。因为mysql一遇到分号,它就要自动执行。即,在语句return '';时,mysql数据库解释器就要执行了。这种情况下,就需要事先把delimiter换成其它符号,如//或$$。
mysql> delimiter // mysql> create function `shorten`(s varchar(255), n int) mysql> returns varchar(255) mysql> begin mysql> if isnull(s) then mysql> return ''; mysql> elseif nmysql> return left(s, n); mysql> else mysql> if char_length(s) mysql> return s; mysql> else mysql> return concat(left(s, n-10), '...', right(s, 5)); mysql> end if; mysql> end if; mysql> end;//
这样只有当//出现之后,mysql解释器才会执行这段语句
例子:
mysql> delimiter // mysql> create procedure simpleproc (out param1 int) -> begin -> select count(*) into param1 from t; -> end; -> // query ok, 0 rows affected (0.00 sec) mysql> delimiter ; mysql> call simpleproc(@a); query ok, 0 rows affected (0.00 sec) mysql> select @a; +------+ | @a | +------+ | 3 | +------+ 1 row in set (0.00 sec)
本文代码在 mysql 5.0.41-community-nt 下运行通过。
编写了个统计网站访问情况(user agent)的 mysql 数据库存储过程。就是下面的这段 sql 代码。
drop procedure if exists pr_stat_agent; -- call pr_stat_agent ('2008-07-17', '2008-07-18') create procedure pr_stat_agent ( pi_date_from date ,pi_date_to date ) begin -- check input if (pi_date_from is null) then set pi_date_from = current_date(); end if; if (pi_date_to is null) then set pi_date_to = pi_date_from; end if; set pi_date_to = date_add(pi_date_from, interval 1 day); -- stat select agent, count(*) as cnt from apache_log where request_time >= pi_date_from and request_time group by agent order by cnt desc; end;
我在 ems sql manager 2005 for mysql 这个 mysql 图形客户端下可以顺利运行。但是在 sqlyog mysql gui v5.02 这个客户端就会出错。最后找到原因是没有设置好 delimiter 的问题。
默认情况下,delimiter “;” 用于向 mysql 提交查询语句。在存储过程中每个 sql 语句的结尾都有个 “;”,如果这时候,每逢 “;” 就向 mysql 提交的话,当然会出问题了。于是更改 mysql 的 delimiter,上面 mysql 存储过程就编程这样子了:
delimiter //; -- 改变 mysql delimiter 为:“//”
drop procedure if exists pr_stat_agent // -- call pr_stat_agent ('2008-07-17', '2008-07-18') create procedure pr_stat_agent ( pi_date_from date ,pi_date_to date ) begin -- check input if (pi_date_from is null) then set pi_date_from = current_date(); end if; if (pi_date_to is null) then set pi_date_to = pi_date_from; end if; set pi_date_to = date_add(pi_date_from, interval 1 day); -- stat select agent, count(*) as cnt from apache_log where request_time >= pi_date_from and request_time group by agent order by cnt desc; end; // delimiter ;
改回默认的 mysql delimiter:“;”
当然,mysql delimiter 符号是可以自由设定的,你可以用 “/” 或者“$$” 等。但是 mysql数据库 存储过程中比较常见的用法是 “//” 和 “$$”。上面的这段在 sqlyog 中的代码搬到 mysql 命令客户端(mysql command line client)却不能执行。
mysql> delimiter //; -- 改变 mysql delimiter 为:“//”
mysql> mysql> drop procedure if exists pr_stat_agent // -> -> -- call pr_stat_agent ('2008-07-17', '2008-07-18') -> -> create procedure pr_stat_agent -> ( -> pi_date_from date -> ,pi_date_to date -> ) -> begin -> -- check input -> if (pi_date_from is null) then -> set pi_date_from = current_date(); -> end if; -> -> if (pi_date_to is null) then -> set pi_date_to = pi_date_from; -> end if; -> -> set pi_date_to = date_add(pi_date_from, interval 1 day); -> -> -- stat -> select agent, count(*) as cnt -> from apache_log -> where request_time >= pi_date_from -> and request_time -> group by agent -> order by cnt desc; -> end; // -> -> delimiter ;
改回默认的 mysql delimiter:“;”
-> // -> // -> // -> ; -> ; ->
真是奇怪了!最后终于发现问题了,在 mysql 命令行下运行 “delimiter //; ” 则 mysql 的 delimiter 实际上是 “//;”,而不是我们所预想的 “//”。其实只要运行指令 “delimiter //” 就 ok 了。
mysql> delimiter // -- 末尾不要符号 “;”
mysql> mysql> drop procedure if exists pr_stat_agent // query ok, 0 rows affected (0.00 sec) mysql> mysql> -- call pr_stat_agent ('2008-07-17', '2008-07-18') mysql> mysql> create procedure pr_stat_agent -> ( -> pi_date_from date -> ,pi_date_to date -> ) -> begin -> -- check input -> if (pi_date_from is null) then -> set pi_date_from = current_date(); -> end if; -> -> if (pi_date_to is null) then -> set pi_date_to = pi_date_from; -> end if; -> -> set pi_date_to = date_add(pi_date_from, interval 1 day); -> -> -- stat -> select agent, count(*) as cnt -> from apache_log -> where request_time >= pi_date_from -> and request_time -> group by agent -> order by cnt desc; -> end; // query ok, 0 rows affected (0.00 sec) mysql> mysql> delimiter ;
末尾不要符号 “//”
mysql>
顺带一提的是,我们可以在 mysql 数据库中执行在文件中的 sql 代码。例如,我把上面存储过程的代码放在文件 d:/pr_stat_agent.sql 中。可以运行下面的代码建立存储过程。
mysql> source d:/pr_stat_agent.sql query ok, 0 rows affected (0.00 sec) query ok, 0 rows affected (0.00 sec)
source 指令的缩写形式是:“/.”
mysql> /. d:/pr_stat_agent.sql query ok, 0 rows affected (0.00 sec) query ok, 0 rows affected (0.00 sec)
最后,可见 mysql数据库的客户端工具在有些地方是各自为政,各有各的一套。