Oracle兼容-语法-Oracle COMMENT

1. 语法

在 ORACLE 模式下，GreatSQL客户端支持Oracle风格注释用法：

  1. 支持Oracle风格的注释符，即在 -- 后直接添加注释内容，无需像在GreatSQL原生模式下，必须在注释符后紧跟空格才行。
  2. 在SQL语句、视图、函数、存储过程、触发器、包中支持Oracle风格注释符。
1. SET sql_mode = ORACLE;

3. --comment notes

5. -- comment notes

2. Oracle兼容说明

GreatSQL客户端在处理注释符后 是否立即紧跟空格 时有所区别：

  1. 切换到ORACLE模式后，GreatSQL客户端支持在注释符--后立即紧跟注释内容，而无需添加空格。
  2. 在GreatSQL客户端中，如果注释符 -- 后没有紧跟空格，则注释内容中出现第一个分号;后会被当做结束符（前提是此时分隔符也是分号;，即DELIMITER ;），结束符之后的内容会被当做SQL请求提交。如果注释符 -- 后紧跟空格，则在同一行范围内，所有内容都会被视为注释内容，不会被做SQL请求提交。
  3. 每一个注释符 -- 只能覆盖同一行范围，另起一行时，需要再次添加注释符才行，否则会被当做SQL请求提交。

几个示例展示区别：

1. greatsql> SET sql_mode = ORACLE;

3. -- 1. 注释符后没有紧跟空格，出现第一个分号;后会被当做结束符，结束符之后的内容会被当做SQL请求提交。
4. greatsql> --a;b;
5. Query OK, 0 rows affected (0.00 sec)

7. ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'b' at line 1

9. -- 将分隔符修改成不是分号
10. greatsql> DELIMITER //
11. greatsql> --a;b; //
12. Query OK, 0 rows affected (0.00 sec)
13. greatsql> DELIMITER ;

15. -- 2. 如果注释符 `--` 后紧>跟空格，则在同一行范围内，所有内容都会被视为注释内容，不会被做SQL请求提交。
16. greatsql> -- a;b;
17. greatsql>

19. -- 3. 每一个注释符 `--` 只能覆盖同一行范围，另起一行时，需要再次添加注释符才行，否则会被当做SQL请求提交。
20. greatsql> --a
21. -> b;
22. ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'b' at line 2

4. 示例

先创建测试表，并写入数据：

1. greatsql> CREATE TABLE t1(a INT NOT NULL, b INT NOT NULL, c INT NOT NULL);
2. Query OK, 0 rows affected (0.07 sec)

4. greatsql> INSERT INTO t1 VALUES(1,1,1), (10,10,10), (20,20,20);
  • 示例1. 常规用法
1. greatsql> SET sql_mode = DEFAULT;

3. -- 在DEFAULT模式下，不支持不带空格的注释符，会被当做运算符处理
4. greatsql> SELECT t1.a --t1.b
5. , t1.c FROM t1;
6. +-------------+----+
7. | t1.a --t1.b | c  |
8. +-------------+----+
9. |           2 |  1 |
10. |          20 | 10 |
11. |          40 | 20 |
12. +-------------+----+

14. -- 在DEFAULT模式下，注释符后必须带空格
15. greatsql> SELECT t1.a -- t1.b
16. , t1.c FROM t1;
17. +----+----+
18. | a  | c  |
19. +----+----+
20. |  1 |  1 |
21. | 10 | 10 |
22. | 20 | 20 |
23. +----+----+

25. -- 切换到ORACLE模式，注释符后是否紧跟空格的效果是一样的
26. greatsql> SET sql_mode = ORACLE;

28. greatsql> SELECT t1.a,
29. --t1.b,
30. t1.c
31. FROM t1;
32. +----+----+
33. | a  | c  |
34. +----+----+
35. |  1 |  1 |
36. | 10 | 10 |
37. | 20 | 20 |
38. +----+----+

40. greatsql> SELECT t1.a,
41. -- t1.b,
42. t1.c
43. FROM t1;
44. +----+----+
45. | a  | c  |
46. +----+----+
47. |  1 |  1 |
48. | 10 | 10 |
49. | 20 | 20 |
50. +----+----+
  • 示例2. 在视图(VIEW)中使用注释符
1. -- 在示例1的基础上创建视图
2. greatsql> SET sql_mode = ORACLE;

4. greatsql> CREATE VIEW v1 AS--SELECT SYSDATE FROM DUAL
5. --SELECT SYSDATE FROM DUAL
6. SELECT * FROM t1;

8. greatsql> SELECT * FROM v1;
9. +----+----+----+
10. | a  | b  | c  |
11. +----+----+----+
12. |  1 |  1 |  1 |
13. | 10 | 10 | 10 |
14. | 20 | 20 | 20 |
15. +----+----+----+
  • 示例3. 在存储过程(STORE PROCEDURE)中使用注释符
1. -- 在示例1的基础上创建存储过程
2. greatsql> SET sql_mode = ORACLE;

4. greatsql> DELIMITER //
5. greatsql> CREATE OR REPLACE PROCEDURE p1 AS--SELECT SYSDATE AS D1 FROM DUAL
6. --SELECT SYSDATE AS D2 FROM DUAL
7. BEGIN--SELECT SYSDATE AS D5 FROM DUAL
8. --SELECT SYSDATE AS D6 FROM DUAL
9. SELECT * FROM t1 WHERE a=1;--SELECT SYSDATE AS D7 FROM DUAL
10. --SELECT SYSDATE AS D8 FROM DUAL
11. end;--SELECT SYSDATE AS D8 FROM DUAL
12. //

14. greatsql> CALL p1() //
15. +---+---+---+
16. | a | b | c |
17. +---+---+---+
18. | 1 | 1 | 1 |
19. +---+---+---+

问题反馈

联系我们

扫码关注微信公众号

greatsql-wx