描述

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

格式

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

参数说明

参数

描述

OR REPLACE

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

PUBLIC

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

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

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

[ schema. ]synonym

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

[ schema. ]object

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

举例

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

注意事项

创建同义词时,需要满足如下权限要求:

  • 在当前的 schema 下创建私有的 synonym,需要 CREATE SYNONYM 权限
  • 在非当前 schema 下创建私有的 synonym,需要 CREATE ANY SYNONYM 权限
  • 创建 PUBLIC 的 synonym,需要 CREATE PUBLIC SYNONYM 权限
  • 对于需要创建 synonym 的对象不需要存在,也不需要具有访问权限
  1. // 创建synonym_user
  2. OceanBase(TEST@TEST)>CREATE USER synonym_user IDENTIFIED BY synonym_user;
  3. Query OK, 0 rows affected (0.04 sec)
  4. OceanBase(TEST@TEST)>grant CREATE on test.* to synonym_user;
  5. Query OK, 0 rows affected (0.05 sec)
  6. OceanBase(TEST@TEST)>grant SELECT on test.* to synonym_user;
  7. Query OK, 0 rows affected (0.02 sec)
  8. // 连接synonym_user
  9. OceanBase(SYNONYM_USER@TEST)>create or replace synonym s1 for t1;
  10. ERROR-00600: internal error code, arguments: -5036, Access denied; you need (at least one of) the CREATE SYNONYM privilege(s) for this operation
  11. // 重新给定CREATE SYNONYM权限
  12. OceanBase(TEST@TEST)>grant CREATE SYNONYM on *.* to synonym_user;
  13. Query OK, 0 rows affected (0.03 sec)
  14. OceanBase(SYNONYM_USER@TEST)>create synonym s1 for t1;
  15. Query OK, 0 rows affected (0.07 sec)