【Mysql】MySql中delimiter的作用

先说结论

MySql中delimiter的作用

Mysql 中默认命令的终止符是; , 但有时候，不希望MySQL这么做，因为你输入的sql 语句可能要包含多句，句中也包含了;, 这时候就要使用delimiter换终止符啦！

例子

默认情况下，delimiter是分号;。在命令行客户端中，如果有一行命令以分号结束，
那么回车后，mysql将会执行该命令。如输入下面的语句

mysql> select * from test_table; 

然后回车，那么MySQL将立即执行该语句。

那么，执行多语句的sql 就要换终止符啦。例如要mysql 命令行客户端执行以下的sql 语句：

mysql> CREATE FUNCTION `SHORTEN`(S VARCHAR(255), N INT) mysql> RETURNS varchar(255) mysql> BEGIN mysql> IF ISNULL(S) THEN mysql> RETURN ''; mysql> ELSEIF N<15 THEN mysql> RETURN LEFT(S, N); mysql> ELSE mysql> IF CHAR_LENGTH(S) <=N THEN mysql> RETURN S; mysql> ELSE mysql> RETURN CONCAT(LEFT(S, N-10), '...', RIGHT(S, 5)); mysql> END IF; mysql> END IF; mysql> END; 

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 N<15 THEN mysql> RETURN LEFT(S, N); mysql> ELSE mysql> IF CHAR_LENGTH(S) <=N THEN 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 < pi_date_to 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 < pi_date_to 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 < pi_date_to -> 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 < pi_date_to -> 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 的客户端工具在有些地方是各自为政，各有各的一套。