# 注释

在本教程中，您将学习如何使用MySQL注释来记录MySQL中的SQL语句或代码块。

## 注释

注释可用于记录SQL语句的目的或存储过程中代码块的逻辑。解析SQL代码时，MySQL会忽略注释部分。 它只执行除了可执行注释之外的SQL部分，我们将在下一节讨论。

MySQL支持三种注释样式(方式)：

**样式一：** 从`--`到行尾

双重冲突注释样式至少需要在第二个破折号之后的空格或控制字符(空格，制表符，换行符等)。

```sql
SELECT * FROM users; -- This is a comment
```

请注意，标准SQL在第二个破折号后不需要空格。 MySQL使用空白来避免某些SQL构造的问题，如：

```sql
SELECT 10--1;
```

该语句返回`11`。

**样式二：** 从`--`到行尾

参考如下查询语句-

```sql
SELECT 
    lastName, firstName
FROM
    employees
WHERE
    reportsTo = 1002; # get subordinates of Diane
```

**样式三：**

C语言风格的注释`/* */`可以跨越多行。您使用此注释样式记录一个SQL代码块。

```sql
/*
    Get sales rep employees
    that reports to Anthony
*/

SELECT 
    lastName, firstName
FROM
    employees
WHERE
    reportsTo = 1143
        AND jobTitle = 'Sales Rep';
```

> 请注意，MySQL不支持嵌套注释。

## 可执行的注释

MySQL提供可执行注释来支持不同数据库之间的可移植性。这些注释允许嵌入仅能在MySQL中执行，但不能在其他数据库执行SQL代码。

下面说明了可执行注释语法：

```sql
/*! MySQL-specific code */
```

例如，以下语句使用可执行注释：

```sql
SELECT 1 /*! +1 */ ;
```

该语句返回`2`而不是1。但是，如果在其他数据库系统中执行，则返回1。

字符串`"#####"`表示可以执行注释的最小版本的MySQL。 第一个`＃`表示主要版本，例如`5`或`8`，第二个`2`个数字(`##`)是次要版本。 最后`2`个(`##`)表示补丁级别。

例如，以下注释只能在MySQL 5.1.10或更高版本中执行：

```sql
CREATE TABLE t1 (
    k INT AUTO_INCREMENT,
    KEY (k)
)  /*!50110 KEY_BLOCK_SIZE=1024; */
```

在本教程中，您已经学会了如何使用MySQL注释来记录MySQL中的SQL代码。