MySQL Server當前支持如下3種註釋風格： 以'# '開頭的單行註釋 以'-- '開頭的單行註釋 C語言風格的單行/多行註釋 如下sql腳本給出了3種註釋風格的示例： /* 這是一個 多行註釋 示例 */ select 1 from dual; select 2 from dual; # 單 ...
MySQL Server當前支持如下3種註釋風格：
- 以'# '開頭的單行註釋
- 以'-- '開頭的單行註釋
- C語言風格的單行/多行註釋
如下sql腳本給出了3種註釋風格的示例：
/* 這是一個
多行註釋
示例
*/
select 1 from dual;
select 2 from dual; # 單行註釋用例1
select 3 from dual; -- 單行註釋用例2
可執行註釋
為了支持在不同資料庫之間的可移植性，MySQL Server針對C風格的註釋在解析上做了一些擴展，當註釋滿足如下風格時，MySQL Server將會解析並執行註釋中的代碼：
/*! MySQL-specific code */
通過比較如下兩個帶註釋的sql語句的執行結果可以比較直觀地看出可執行註釋語句的行為：
# 普通註釋，'+1' 被忽略
mysql> select 1 /* +1 */;
+---+
| 1 |
+---+
| 1 |
+---+
# 可執行註釋，'+1' 被當成語句的一部分
mysql> select 1 /*! +1 */;
+-------+
| 1 +1 |
+-------+
| 2 |
+-------+
藉助這一特性，我們就有機會編寫具備較好移植性的SQL語句, 在使MySQL獨有特性的同時，保證了sql在其它資料庫也能夠成功被執行：
create table t1（col1 int） /*! engine=MyISAM */;
select /*! STRAIGHT_JOIN */ col1 from t1;
...
/*!version-number SQL*/
在日常使用中，我們還會經常看到如下格式的註釋語句：
/*!50003 SET @OLD_COMPLETION_TYPE=@@COMPLETION_TYPE */
/*!80000 SET SESSION information_schema_stats_expiry=0 */
/*!50013 DEFINER=`root`@`localhost` SQL SECURITY DEFINER */
/*!跟的5位數字為版本指示器，其與資料庫版本的對應規則為：
'/' '*' '!', followed by exactly
第1位：主版本號(VERSION_MAJOR),
第2, 3位：小版本號(VERSION_MINOR),
第4, 5位：Patch號(VERSION_PATCH)
示例：
32302 -> 3.23.02
50738 -> 5.7.38
80025 -> 8.0.25
以上述第一個註釋語句為例，它的含義可以描述為：當MySQL資料庫版本為5.0.3或更高版本時，將SET @OLD_COMPLETION_TYPE=@@COMPLETION_TYPE讀取出來參與sql語法解析，並最終被執行；當MySQL版本低於5.0.3時，該行語句被當成一個普通的註釋。不難看出，帶version_number的可執行註釋，是為瞭解決不同的MySQL版本之間的相容問題。以8.0.23版本新增的Invisible Columnsw為例, 如下建表語句在8.0.23版本之前將無法執行：
CREATE TABLE t1 (i INT, j DATE INVISIBLE);
如下的語句改造則保證了建表語句的向下版本相容：
CREATE TABLE t1 (i INT, j DATE /*!80023 INVISIBLE */);
實際上，在我們常用的工具mysqldump也借用這個特性，使得產生的sql能夠相容不同的資料庫版本：
/*mysqldump 代碼片段*/
dump_fputs(
sql_file,
"/*!50717 SELECT COUNT(*) INTO @rocksdb_has_p_s_session_variables"
" FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA ="
" 'performance_schema' AND TABLE_NAME = 'session_variables'"
" */;\n"
"/*!50717 SET @rocksdb_get_is_supported = IF"
" (@rocksdb_has_p_s_session_variables, 'SELECT COUNT(*) INTO"
" @rocksdb_is_supported FROM performance_schema.session_variables"
" WHERE VARIABLE_NAME=\\'rocksdb_bulk_load\\'', 'SELECT 0') */;\n"
"/*!50717 PREPARE s FROM @rocksdb_get_is_supported */;\n"
"/*!50717 EXECUTE s */;\n"
"/*!50717 DEALLOCATE PREPARE s */;\n"
"/*!50717 SET @rocksdb_enable_bulk_load = IF"
" (@rocksdb_is_supported, 'SET SESSION rocksdb_bulk_load = 1',"
" 'SET @rocksdb_dummy_bulk_load = 0') */;\n"
"/*!50717 PREPARE s FROM @rocksdb_enable_bulk_load */;\n"
"/*!50717 EXECUTE s */;\n"
"/*!50717 DEALLOCATE PREPARE s */;\n");
check_io(sql_file);
在show create table等語句中我們也能看到類似的應用(sql/sql_show.cc)：
mysql> create table t1 (i int, j date invisible);
Query OK, 0 rows affected (0.03 sec)
mysql> show create table t1;
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table | Create Table |
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
| t1 | CREATE TABLE `t1` (
`i` int DEFAULT NULL,
`j` date DEFAULT NULL /*!80023 INVISIBLE */
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci |
+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.01 sec)
結語
mysql server提供的可執行註釋功能，在橫向跨資料庫和縱向跨版本相容上都為資料庫用戶提供了較大支持，是一個比較便利的特性。功能實現上，mysql server是在詞法解析階段先對語句做了一遍攔截，針對/*!按具體情況做了特殊處理，如有興趣您可以參考mysql的詞法解析相關源碼。註：以8.0.25版本為例，它的相關解析放在sql_lex.cc的lex_one_token()中，在其中您也能看見mysql詞法解析器是怎麼對optimizer hints comments(格式: /*+ optimizer_hints */ ）進行處理的。
Enjoy GreatSQL
