注释语法

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)
  8. mysql> SELECT 1+1; -- This comment continues to the end of line
  9. ++
  10. | 1+1 |
  11. ++
  12. | 2 |
  13. ++
  14. 1 row in set (0.00 sec)
  15. mysql> SELECT 1 /* this is an in-line comment */ + 1;
  16. +--+
  17. | 1 + 1 |
  18. +--+
  19. | 2 |
  20. +--+
  21. 1 row in set (0.01 sec)
  22. mysql> SELECT 1+
  23. -> /*
  24. /*> this is a
  25. /*> multiple-line comment
  26. /*> */
  27. -> 1;
  28. +-+
  29. | 1+
  30. 1 |
  31. +-+
  32. | 2 |
  33. +-+
  34. 1 row in set (0.00 sec)
  35. mysql> SELECT 1+1--1;
  36. +--+
  37. | 1+1--1 |
  38. +--+
  39. | 3 |
  40. +--+
  41. 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 详见这里

更多细节