描述

该语句用来创建一个同义词。

格式

  1. CREATE [ OR REPLACE ] [ PUBLIC ]
  2. SYNONYM [ DATABASE. ]synonym
  3. FOR [ DATABASE. ]object;

参数说明

参数

描述

OR REPLACE

表示如果要创建的同义词名称已存在，则使用新的定义重新创建同义词。

PUBLIC

指定PUBLIC来创建公共同义词，所有用户都可以使用。用户必须对基础对象具有相应的权限才能使用该同义词。

在解析对象的引用时，仅当对象没有指定DataBase时，才会使用公共同义词。

如果不指定PUBLIC，则同义词是私有的，只能当前DataBase访问，并且同义词名称在当前DataBase中必须唯一。

[ DataBase. ]synonym

DataBase指定当前同义词属于哪个DataBase，如果指定了PUBLIC，则对同义词不需要指定DataBase；synonym表示同义词的名称。

[ DataBase. ]object

表示同义词对应对象的名称。

举例

  • 创建一个同义词。
  1. OceanBase(admin@test)>create table t1(c1 int);
  2. Query OK, 0 rows affected (0.18 sec)
  4. OceanBase(admin@test)>create synonym s1 for t1;
  5. Query OK, 0 rows affected (0.05 sec)
  7. OceanBase(admin@test)>insert into s1 values(1);
  8. Query OK, 1 row affected (0.02 sec)
  10. OceanBase(admin@test)>select * from s1;
  11. +------+
  12. | c1   |
  13. +------+
  14. |    1 |
  15. +------+
  16. 1 row in set (0.01 sec)
  • 创建一个PUBLIC同义词
  1. OceanBase(admin@test)>create public synonym syn_pub for t1;
  2. Query OK, 0 rows affected (0.03 sec)
  4. OceanBase(admin@test)>select * from syn_pub;
  5. +------+
  6. | c1   |
  7. +------+
  8. |    1 |
  9. +------+
  10. 1 row in set (0.01 sec)

注意事项

创建同义词时，需要满足如下权限要求：

  • 在当前的DataBase下创建私有的synonym，需要CREATE SYNONYM权限
  • 在非当前DataBase下创建私有的synonym，需要CREATE ANY SYNONYM权限
  • 创建PUBLIC的synonym，需要CREATE PUBLIC SYNONYM权限
  • 对于需要创建synonym的对象不需要存在，也不需要具有访问权限
  1. 连接sys用户:
  2. OceanBase(ADMIN@TEST)>CREATE USER syn_user IDENTIFIED BY syn_user;
  3. Query OK, 0 rows affected (0.06 sec)
  5. OceanBase(ADMIN@TEST)>grant CREATE on syn_user.* to syn_user;
  6. Query OK, 0 rows affected (0.02 sec)
  8. OceanBase(ADMIN@TEST)>grant SELECT on syn_user.* to syn_user;
  9. Query OK, 0 rows affected (0.03 sec)
  12. 连接syn_user
  13. //创建同义词失败
  14. OceanBase(SYN_USER@(none))>create synonym syn_1 for t1;
  15. ERROR-00600: internal error code, arguments: -5036, Access denied; you need (at least one of) the CREATE SYNONYM privilege(s) for this operation
  17. 连接sys用户,给定CREATE SYNONYM权限
  18. OceanBase(ADMIN@TEST)>grant CREATE SYNONYM on *.* to syn_user;
  19. Query OK, 0 rows affected (0.03 sec)
  21. 连接syn_user
  22. OceanBase(SYN_USER@(none))>create synonym syn_1 for t1;
  23. Query OK, 0 rows affected (0.05 sec)