3.8 MySQL注释

每一种语言都有自己的注释方式，代码量越多，代码注释的重要性也就越明显。一般情况下，注释可以出现在程序中的任何位置，用来向用户或程序员提示或解释程序的功能及作用。

注释在 SQL 语句中用来标识说明或者注意事项的部分，对 SQL 的执行没有任何影响。因此，注释内容中无论是英文字母还是汉字都可以随意使用。

MySQL 注释分为单行注释和多行注释，下面分别来介绍这两种注释。

MySQL 单行注释

1. 单行注释可以使用 # 注释符，# 注释符后直接加注释内容。格式如下：

   #注释内容
   

   单行注释使用注释符#的示例如下：

   #从结果中删除重复行
   SELECT DISTINCT product_id, purchase_price FROM Product;
   

2. 单行注释可以使用--注释符，--注释符后需要加一个空格，注释才能生效。格式如下：

   -- 注释内容
   

   单行注释使用注释符--的示例如下：

   -- 从结果中删除重复行
   SELECT DISTINCT product_id, purchase_price FROM Product;
   

   #和--的区别就是：#后面直接加注释内容，而--的第 2 个破折号后需要跟一个空格符在加注释内容。

MySQL 多行注释

多行注释使用/* */注释符。/*用于注释内容的开头，*/用于注释内容的结尾。多行注释格式如下：

/*
  第一行注释内容
  第二行注释内容
*/

注释内容写在/*和*/之间，可以跨多行。

多行注释的使用示例如下

/*这条SELECT语句，
  会从结果中删除重复行*/
SELECT DISTINCT product_id, purchase_price FROM Product;

任何注释（单行注释和多行注释）都可以插在 SQL 语句中，且注释可以放在 SQL 语句中的任意位置。

在 SQL 语句中插入单行注释，如下所示：

SELECT DISTINCT product_id, purchase_price
-- 从结果中删除重复行。 
FROM Product;
SELECT DISTINCT product_id, purchase_price
#从结果中删除重复行。 
FROM Product;

在 SQL 语句中插入多行注释，如下所示：

SELECT DISTINCT product_id, purchase_price
/* 这条SELECT语句，  
    会从结果中删除重复行。*/ 
    FROM Product;

注释可以写在任何 SQL 语句当中，且 SQL 语句中对注释的数量没有限制。

MySQL 注释能够帮助阅读者更好地理解 SQL 语句，特别是在使用复杂的 SQL 语句时，所以大家应该尽量多添加一些简明易懂的注释。