MySQL DELIMITER 命令詳解：存儲過程/觸發器定義中的語句終結符管理

什麼是 DELIMITER？

DELIMITER 是 MySQL 客戶端程序（mysql、mysqladmin 等）**而非服務器**的指令，用於**重新定義 SQL 語句的結束標識符**。默認終結符為分號 ;。

為什麼需要修改 DELIMITER？

在定義**存儲過程**、**觸發器**、**函數**、**事件**等複合語句時，語句體內部包含多條以 ; 結束的子語句。若保持默認 ;，客戶端會在第一個 ; 處提交執行，導致語法錯誤或定義不完整。

標準用法流程

-- 1. 修改終結符為自定義字符（常用 // 或 $$）
DELIMITER //

-- 2. 編寫複合語句，內部自由使用 ;，結尾使用新終結符
CREATE PROCEDURE simpleproc(OUT param1 INT)
BEGIN
    SELECT COUNT(*) INTO param1 FROM t;
END //

-- 3. 恢復默認終結符
DELIMITER ;

-- 4. 調用驗證
CALL simpleproc(@a);
SELECT @a;

完整示例：統計網站 User Agent 的存儲過程

DELIMITER //

DROP PROCEDURE IF EXISTS pr_stat_agent //

CREATE PROCEDURE pr_stat_agent (
    IN pi_date_from DATE,
    IN pi_date_to   DATE
)
BEGIN
    -- 參數校驗與默認值
    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;
    -- 統計下一天 0 點為邊界（左閉右開）
    SET pi_date_to = DATE_ADD(pi_date_from, INTERVAL 1 DAY);

    -- 核心統計查詢
    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 ;

-- 調用示例
CALL pr_stat_agent('2023-01-01', '2023-01-07');

客戶端工具差異與兼容性

最佳實踐與避坑指南

1. 統一團隊約定：存儲過程腳本文件**統一使用 //** 作為 DELIMITER，文件頭尾必配對
2. 腳本文件結構規範：

   -- file: create_proc_stat.sql
   DELIMITER //
   
   DROP PROCEDURE IF EXISTS pr_xxx //
   CREATE PROCEDURE pr_xxx (...) BEGIN ... END //
   
   DELIMITER ;

3. 避免在應用代碼中使用 DELIMITER：Java/Python/PHP 等驅動**不需要也不支持** DELIMITER，直接發送完整 CREATE 语句字符串
4. 嵌套複合語句：函數內無法再定義存儲過程，MySQL 不支持嵌套定義
5. 注釋風格：複合語句內推薦使用 -- 单行注釋 或 /* 多行 */，注意 -- 後需有空格
6. 無 RETURN 關鍵字：存儲過程用 OUT/INOUT 參數或 SELECT 返回結果，**不能使用 RETURN**（僅函數可用）

總結

DELIMITER 是**客戶端層面**的語句邊界標識，解決「語句中包含語句終結符」的歧義問題。**核心口訣：定義前改 //，定義後改 ;，驅動層不用，工具裡配好**。規範腳本文件結構、統一團隊習慣、區分交互與程序化調用場景，即可避開 90% 的存儲過程創建失敗坑。