VastbaseG100

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

Menu

CREATE PUBLICATION

功能描述

向当前数据库添加一个新的发布,发布的名称必须与当前数据库中任何现有发布的名称不同。发布本质上是将一组表的数据变更进行逻辑复制。

注意事项

  • 如果既没有指定FOR TABLE,也没有指定FOR ALL TABLES, 那么这个发布就是以一组空表开始的,可以在后续添加表。

  • 创建发布不会开始复制。它只为未来的订阅者定义一个分组和过滤逻辑。 要创建一个发布,调用者必须拥有当前数据库的CREATE权限。(当然,系统管理员不需要这个检查。)

  • 要将表添加到发布中,调用者必须拥有该表的所有权。FOR ALL TABLES子句要求调用者是具有SYSADMIN权限用户。

  • 添加到发布UPDATE或DELETE操作的发布的表必须已经定义了REPLICA IDENTITY,否则将在这些表上禁止这些操作。

  • COPY ... FROM命令是作为INSERT操作发布的。不发布TRUNCATE和DDL操作。

  • 暂不支持跨数据库版本进行逻辑复制。

语法格式

CREATE PUBLICATION name
    [ FOR TABLE table_name [, ...]
      | FOR ALL TABLES ]
    [ WITH ( publication_parameter [= value] [, ... ] ) ]

参数说明

  • name

    新发布的名称。

  • FOR TABLE table_name [, …]

    指定要添加到发布的表的列表。 只有持久基表才能成为发布的一部分,临时表、非日志表、外表、MOT表、物化视图、常规视图不能被发布。

    table_name [, …]表示指定要添加到发布的表名或表名列表。

  • FOR ALL TABLES

    将发布标记为复制数据库中所有表的更改,包括在将来创建的表。

  • WITH ( publication_parameter [= value] [, … ] )

    该子句指定发布的可选参数。支持如下参数:

    • publish (string):这个参数决定了哪些DML操作可以发布给订阅者。该值是一个用逗号分隔的操作列表,允许的操作是insert、update和delete,不指定则默认发布所有的动作。该选项的默认值是insert, update, delete

    • ddl (string):这个参数决定了哪些DDL操作可以发布给订阅者。该值是一个用逗号分隔的操作列表,允许的操作是none、table、all,不指定则默认不发布DDL操作。该选项的默认值是'none'。

      • none: 表示不发布DDL操作。
      • table: 表示只发布数据表的DDL操作。
      • all: 表示发布所有的DDL操作,目前支持的对象类型有TABLE和INDEX,设置为该值时,只允许FOR ALL TABLES 选项。

示例

前置条件:创建测试用表。

create table users(a int);
create table departments(b int);
create table mydata(c int);

示例

1、创建一个发布,发布两个表中所有更改。

CREATE PUBLICATION mypublication FOR TABLE users, departments;

2、创建一个发布,发布所有表中的所有更改。

CREATE PUBLICATION alltables FOR ALL TABLES;

3、创建一个发布,只发布一个表中的INSERT操作。

CREATE PUBLICATION insert_only FOR TABLE mydata WITH (publish = 'insert');

4、修改发布的动作。

ALTER PUBLICATION insert_only SET (publish='insert,update,delete');

5、删除发布。

DROP PUBLICATION insert_only;

6、创建一个发布,发布所有的DDL操作。

CREATE PUBLICATION ddl_all FOR ALL TABLES WITH (ddl='all');

7、创建一个发布,发布类型为TABLE的DDL操作。

CREATE PUBLICATION ddl_all FOR ALL TABLES WITH (ddl='table');

相关链接

ALTER PUBLICATIONDROP PUBLICATION