# CREATE SYNONYM
#### 功能描述
创建一个同义词对象。同义词是数据库对象的别名，用于记录与其他数据库对象名间的映射关系，用户可以使用同义词访问关联的数据库对象。
#### 注意事项
- 定义同义词的用户成为其所有者。
- 若指定模式名称，则同义词在指定模式中创建。否则，在当前模式创建。
- 支持通过同义词访问的数据库对象包括：表、视图、函数和存储过程。
- 使用同义词时，用户需要具有对关联对象的相应权限。
- 支持使用同义词的DML语句包括：SELECT、INSERT、UPDATE、DELETE、EXPLAIN、CALL。
- 不支持关联函数或存储过程的CREATE SYNONYM语句出现在存储过程中，建议存储过程中使用系统表pg_synonym中已存在的同义词对象。
 
#### 语法格式
```
CREATE [ OR REPLACE ] SYNONYM synonym_name 
    FOR object_name;
```
#### 参数说明
表1CREATE SYNONYM参数说明 
| 参数          | 描述                                                                                                                                     | 取值范围                                                                                                                                    |
|:---|:---|:---|
| synonym     | 创建的同义词名字，可以带模式名。                                                                                                                       | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-dws/dws_06_0007.html#ZH-CN_TOPIC_0000001811634529__section1475018612353)。 |
| object_name | 关联的对象名字，可以带模式名。 说明： object_name可以是不存在的对象名称。 | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-dws/dws_06_0007.html#ZH-CN_TOPIC_0000001811634529__section1475018612353)。 |
   
#### 示例
创建模式ot。
```
DROP SCHEMA IF EXISTS ot;
CREATE SCHEMA ot;
```
创建表ot.t1及其同义词t1。
```
CREATE TABLE ot.t1(id int, name varchar2(10)) DISTRIBUTE BY hash(id);
DROP SYNONYM IF EXISTS t1;
CREATE OR REPLACE SYNONYM t1 FOR ot.t1;
```
使用同义词t1。
```
SELECT * FROM t1;
INSERT INTO t1 VALUES (1, 'ada'), (2, 'bob');
UPDATE t1 SET t1.name = 'cici' WHERE t1.id = 2;
```
创建同义词v1及其关联视图ot.v_t1。
```
DROP SYNONYM IF EXISTS v1;
CREATE SYNONYM v1 FOR ot.v_t1;
CREATE VIEW ot.v_t1 AS SELECT * FROM ot.t1;
```
使用同义词v1。
```
SELECT * FROM v1;
```
![](https://support.huaweicloud.com/sqlreference-dws/figure/zh-cn_image_0000002598390897.png "点击放大")
创建重载函数ot.add及其同义词add。
```
CREATE OR REPLACE FUNCTION ot.add(a integer, b integer) RETURNS integer AS
$$
SELECT $1 + $2
$$
LANGUAGE sql;
CREATE OR REPLACE FUNCTION ot.add(a decimal(5,2), b decimal(5,2)) RETURNS decimal(5,2) AS
$$
SELECT $1 + $2
$$
LANGUAGE sql;
CREATE OR REPLACE SYNONYM add FOR ot.add;
```
使用同义词add。
```
SELECT add(1,2);
SELECT add(1.2,2.3);
```
![](https://support.huaweicloud.com/sqlreference-dws/figure/zh-cn_image_0000002598391165.png "点击放大")
创建存储过程ot.register及其同义词register。
```
DROP PROCEDURE IF EXISTS ot.register;
CREATE PROCEDURE ot.register(n_id integer, n_name varchar2(10))
SECURITY INVOKER
AS
BEGIN
    INSERT INTO ot.t1 VALUES(n_id, n_name);
END;
/
CREATE OR REPLACE SYNONYM register FOR ot.register;
```
使用同义词register，调用存储过程。
```
CALL register(3,'mia');
```
#### 相关链接
[ALTER SYNONYM](https://support.huaweicloud.com/sqlreference-dws/dws_06_0140.html)，[DROP SYNONYM](https://support.huaweicloud.com/sqlreference-dws/dws_06_0207.html)