VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

CREATE SYNONYM

功能描述

创建一个同义词对象。同义词是数据库对象的别名,用于记录与其他数据库对象名间的映射关系,用户可以使用同义词访问关联的数据库对象。

注意事项

  • 定义同义词的用户成为其所有者。
  • 若指定模式名称,则同义词在指定模式中创建。否则,在当前模式创建。
  • 支持通过同义词访问的数据库对象包括:表、视图、序列、函数和存储过程。
  • 使用同义词时,用户需要具有对关联对象的相应权限。
  • 支持使用同义词的DML语句包括:SELECT、INSERT、UPDATE、DELETE、EXPLAIN、CALL、REFRESH。
  • 不建议对临时表创建同义词。如果需要创建的话,需要指定同义词的目标临时表的模式名,否则无法正常使用该同义词,并且在当前会话结束前执行DROP SYNONYM命令。
  • 删除原对象后,与之关联同义词不会被级联删除,继续访问该同义词会报错,并提示已失效。

语法格式

CREATE [ OR REPLACE ] SYNONYM synonym_name 
    FOR object_name;

参数说明

  • synonym

    创建的同义词名字,可以带模式名。

    取值范围:字符串,要符合标识符的命名规范。

  • object_name

    关联的对象名字,可以带模式名。

    取值范围:字符串,要符合标识符的命名规范。

    说明: object_name可以是不存在的对象名称。

示例

1、创建模式ot。

CREATE SCHEMA ot;

2、创建表ot.t1及其同义词t1。

CREATE TABLE ot.t1(id int, name varchar2(10));
CREATE OR REPLACE SYNONYM t1 FOR ot.t1;

3、使用同义词t1。

SELECT * FROM t1;
INSERT INTO t1 VALUES (1, 'ada'), (2, 'bob');
UPDATE t1 SET t1.name = 'cici' WHERE t1.id = 2;

4、创建同义词v1及其关联视图ot.v_t1。

CREATE SYNONYM v1 FOR ot.v_t1;
CREATE VIEW ot.v_t1 AS SELECT * FROM ot.t1;

5、使用同义词v1。

SELECT * FROM v1;

6、创建重载函数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;

7、使用同义词add。

SELECT add(1,2);
SELECT add(1.2,2.3);

8、创建存储过程ot.register及其同义词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;

9、使用同义词register,调用存储过程。

CALL register(3,'mia');

10、创建序列,并为序列创建同义词。

create table ot.tab_1100628(id int);
create sequence ot.sequ1_1100628 increment 1 maxvalue 200 start with 1 owned by ot.tab_1100628.id;
create synonym syn1_1100628 for sequ1_1100628;

11、创建调用同义词的函数。

create function fun_1100628(n int)return int
as
a1 int;
begin
for i in 1..n loop
insert into ot.tab_1100628 value(syn1_1100628.nextval);
end loop;
select count(*) into a1 from ot.tab_1100628;
return a1;
end;
/

12、调用函数。

select fun_1100628(3);

返回结果为:

fun_1100628
------------
          3
(1 row)

13、删除同义词。

DROP SYNONYM t1;
DROP SYNONYM IF EXISTS v1;
DROP SYNONYM IF EXISTS add;
DROP SYNONYM register;
DROP SYNONYM syn1_1100628;
DROP SCHEMA ot CASCADE;

相关链接

ALTER SYNONYMDROP SYNONYM