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');