【官方】Mysql中注释的规范写法（全部）

注释语法

MySQL数据库服务器支持三种注释语法:

• 从一个 

  #

   到行末。

• 从两个连续横杠 

  -- 

   序列到行尾。 在MySQL中， - （两个连续横杠 ）注释样式要求第二个破折号后跟至少一个空格或控制字符（例如空格，制表符，换行符等）。 此语法与标准SQL注释语法略有不同。

• 从一个 

  /*

   顺序到下一个* /结束， 此语法使注释能够扩展到多行，因为开始和结束序列不必位于同一行。

如下示例演示三种不同的注释样式：

[code]mysql> SELECT 1+1;     # 这条注释到行末
mysql> SELECT 1+1;     -- 这条注释到行末
mysql> SELECT 1 /* 这是一个行内注释（by_liangxin） */ + 1;
mysql> SELECT 1+
/*
说明：Mysql注释演示
作者：梁新
时间：2018-12-26
*/
1;

不支持嵌套注释。 （在某些情况下，可能允许嵌套注释，但通常不允许，用户应该避免使用它们。）

MySQL服务器支持一些C风格的注释变体。 通过使用以下格式的注释，这些使您能够编写包含MySQL扩展的代码，但仍然是可移植的：

[code]/*! MySQL-特定代码 */

在这种情况下，MySQL Server会像在任何其他SQL语句中一样解析和执行注释中的代码，但其他SQL服务器将忽略这些扩展。 例如，MySQL Server在以下语句中识别STRAIGHT_JOIN关键字，但其他服务器不会：

[code]SELECT /*! STRAIGHT_JOIN */ col1 FROM table1,table2 WHERE ...

如果您在之后添加版本号！ 只有当MySQL版本大于或等于指定的版本号时，才会执行注释中的语法。 以下注释中的KEY_BLOCK_SIZE关键字仅由MySQL 5.1.10或更高版本的服务器执行：

[code]CREATE TABLE t1(a INT, KEY (a)) /*!50110 KEY_BLOCK_SIZE=1024 */;

刚才描述的注释语法适用于mysqld服务器如何解析SQL语句。 mysql客户端程序在将语句发送到服务器之前还会对语句进行一些解析。 （这样做是为了确定多语句输入行中的语句边界。）

此格式的注释/ *！12345 ... * /未存储在服务器上。 如果此格式用于注释存储的实体，则注释将不会保留在服务器上。

不支持在多行/ * ... * /注释中使用诸如\ C的短格式mysql命令。