MySQL 服务器支持三种注释样式

以下示例演示了所有三种注释样式

mysql> SELECT 1+1;     # This comment continues to the end of line
mysql> SELECT 1+1;     -- This comment continues to the end of line
mysql> SELECT 1 /* this is an in-line comment */ + 1;
mysql> SELECT 1+
/*
this is a
multiple-line comment
*/
1;

不支持嵌套注释，并且已弃用；预计它们将在未来版本的 MySQL 中被删除。（在某些情况下，可能会允许嵌套注释，但通常不会，用户应该避免使用它们。）

MySQL 服务器支持 C 样式注释的某些变体。这些使您能够编写包含 MySQL 扩展的代码，但仍然是可移植的，方法是使用以下形式的注释

/*! MySQL-specific code */

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

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

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

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

版本号使用格式 Mmmrr，其中 M 是主版本，mm 是两位数的次版本，rr 是两位数的发行版号。例如：在仅由 MySQL 服务器版本 8.4.0 或更高版本运行的语句中，在注释中使用 80400。

在 MySQL 8.4 中，版本号也可以选择包含六位数，格式为 MMmmrr，其中 MM 是两位数的主版本，mm 和 rr 分别是两位数的次版本和两位数的发行版号。

版本号后面应该至少有一个空格字符（或注释的结尾）。如果注释以六位数后跟空格开头，则将其解释为六位数版本号。否则，如果它以至少五位数开头，则将其解释为五位数版本号（并为该目的忽略任何剩余字符）；如果它以少于五位数开头，则注释将被视为正常的 MySQL 注释。

上面描述的注释语法适用于 mysqld 服务器如何解析 SQL 语句。 mysql 客户端程序也会在将语句发送到服务器之前执行一些解析。（它这样做是为了确定多语句输入行内的语句边界。）有关服务器和 mysql 客户端解析器之间差异的信息，请参阅 第 6.5.1.6 节，“mysql 客户端提示”。

/*!12345 ... */ 格式的注释不会存储在服务器上。如果此格式用于注释存储程序，则注释不会保留在程序体中。

C 样式注释语法的另一种变体用于指定优化器提示。提示注释包括 + 字符，它位于 /* 注释打开序列之后。示例

SELECT /*+ BKA(t1) */ FROM ... ;

有关更多信息，请参阅 第 10.9.3 节，“优化器提示”。

不支持在多行 /* ... */ 注释中使用 \C 等短格式的 mysql 命令。短格式命令在单行 /*! ... */ 版本注释中有效，/*+ ... */ 优化器提示注释也是如此，它们存储在对象定义中。如果您担心优化器提示注释可能会存储在对象定义中，因此使用 mysql 重新加载转储文件会导致执行此类命令，则可以调用 mysql 并使用 --binary-mode 选项，或者使用 mysql 以外的其他重新加载客户端。