• 注释语法

    注释语法

    TiDB 支持三种注释风格：

    • 用 # 注释一行
    • 用 -- 注释一行，用 -- 注释必须要在其之后留出至少一个空格。
    • 用 /* */ 注释一块，可以注释多行。

    例：

    1. mysql> SELECT 1+1;     # This comment continues to the end of line
    2. +------+
    3. | 1+1  |
    4. +------+
    5. |    2 |
    6. +------+
    7. 1 row in set (0.00 sec)
    9. mysql> SELECT 1+1;     -- This comment continues to the end of line
    10. +------+
    11. | 1+1  |
    12. +------+
    13. |    2 |
    14. +------+
    15. 1 row in set (0.00 sec)
    17. mysql> SELECT 1 /* this is an in-line comment */ + 1;
    18. +--------+
    19. | 1  + 1 |
    20. +--------+
    21. |      2 |
    22. +--------+
    23. 1 row in set (0.01 sec)
    25. mysql> SELECT 1+
    26.     -> /*
    27.    /*> this is a
    28.    /*> multiple-line comment
    29.    /*> */
    30.     -> 1;
    31. +-------+
    32. | 1+
    34. 1 |
    35. +-------+
    36. |     2 |
    37. +-------+
    38. 1 row in set (0.00 sec)
    40. mysql> SELECT 1+1--1;
    41. +--------+
    42. | 1+1--1 |
    43. +--------+
    44. |      3 |
    45. +--------+
    46. 1 row in set (0.01 sec)

    TiDB 也跟 MySQL 保持一致，支持一种 C 风格注释的变体：

    1. /*! Specific code */

    在这种格式中，TiDB 会执行注释中的语句，这个语法是为了让这些 SQL 在其他的数据库中被忽略，而在 TiDB 中被执行。

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

    在 TiDB 中，这种写法等价于 SELECT STRAIGHT_JOIN col1 FROM table1,table2 WHERE ...

    如果注释中指定了 Server 版本号，例如 /*!50110 KEY_BLOCK_SIZE=1024 */，在 MySQL 中表示只有 MySQL 的版本大于等于 5.1.10 才会处理这个 comment 中的内容。但是在 TiDB 中，这个版本号不会起作用，所有的 comment 都会处理。

    还有一种注释会被当做是优化器 Hint 特殊对待：

    1. SELECT /*+ hint */ FROM ...;

    由于 hint 包含在类似 /+ xxx / 的 comment 里，MySQL 客户端在 5.7.7 之前，会默认把 comment 清除掉，如果需要在旧的客户端使用 hint，需要在启动客户端时加上 —comments 选项，例如 mysql -h 127.0.0.1 -P 4000 -uroot —comments

    TiDB 支持的相关优化器 hint 详见这里

    更多细节。