MySQL注释:单行注释和多行注释

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

下面主要介绍 MySQL 中 SQL 语句的注释方法。

注释在 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 语句时,所以大家应该尽量多添加一些简明易懂的注释。