PostgreSQL / 系统课时
创建 Publication 并选择对象
创建 Publication 并选择对象
Publication 决定发布端哪些表以及哪些数据变更可以被订阅端读取。本节用可复现实验分别创建单表、表集合和全表 Publication,并验证新增表是否自动进入复制范围,以及已有订阅何时需要刷新。
学习目标
- 能按单表、多个指定表或全部表创建 Publication。
- 能判断新建表是否会自动进入现有 Publication。
- 能在发布范围变化后正确刷新已有订阅。
Publication 只定义发布范围
Publication 是发布端数据库中的逻辑对象,它不复制数据,也不保存订阅端信息;它只声明“哪些表的哪些变更允许被发布”。默认 CREATE PUBLICATION 发布 INSERT、UPDATE、DELETE 和 TRUNCATE。
按对象范围看,常见选择有三种:
| 方式 | 典型语法 | 后续新建表 |
|---|---|---|
| 单表 | FOR TABLE public.orders |
不自动加入 |
| 表集合 | FOR TABLE public.orders, public.customers |
不自动加入 |
| 全部表 | FOR ALL TABLES |
自动属于发布范围 |
FOR ALL TABLES 覆盖当前数据库中符合逻辑复制条件的表,也会覆盖未来新建的表。创建全表 Publication 需要超级用户权限;指定表 Publication 则要求创建者拥有相应表。
创建三种 Publication
下面示例应在独立测试数据库中首次执行。为便于观察,先创建三张普通表,再分别建立单表、表集合和全表 Publication。
CREATE TABLE public.lr_orders (
id bigint PRIMARY KEY,
status text NOT NULL
);
CREATE TABLE public.lr_customers (
id bigint PRIMARY KEY,
name text NOT NULL
);
CREATE TABLE public.lr_inventory (
sku text PRIMARY KEY,
quantity integer NOT NULL
);
CREATE PUBLICATION pub_single
FOR TABLE public.lr_orders;
CREATE PUBLICATION pub_core
FOR TABLE public.lr_orders, public.lr_customers;
CREATE PUBLICATION pub_all
FOR ALL TABLES;
SELECT
pubname,
puballtables,
pubinsert,
pubupdate,
pubdelete,
pubtruncate
FROM pg_publication
WHERE pubname IN ('pub_single', 'pub_core', 'pub_all')
ORDER BY pubname;预期输出:
CREATE TABLE
CREATE TABLE
CREATE TABLE
CREATE PUBLICATION
CREATE PUBLICATION
CREATE PUBLICATION
pubname | puballtables | pubinsert | pubupdate | pubdelete | pubtruncate
------------+--------------+-----------+-----------+-----------+------------
pub_all | t | t | t | t | t
pub_core | f | t | t | t | t
pub_single | f | t | t | t | t这里的 puballtables = t 表示 pub_all 是动态的全表范围;另外两个 Publication 只保存显式选择的表集合。
验证新增表的自动加入规则
新建一张表后,可以通过 pg_publication_tables 直接检查它属于哪些 Publication。
CREATE TABLE public.lr_audit (
id bigint PRIMARY KEY,
payload text NOT NULL
);
SELECT pubname, schemaname, tablename
FROM pg_publication_tables
WHERE schemaname = 'public'
AND tablename = 'lr_audit'
ORDER BY pubname;预期结果只有全表 Publication:
CREATE TABLE
pubname | schemaname | tablename
---------+------------+-----------
pub_all | public | lr_audit如果希望把新表加入显式表集合,需要主动修改 Publication。
ALTER PUBLICATION pub_core
ADD TABLE public.lr_audit;
SELECT pubname, schemaname, tablename
FROM pg_publication_tables
WHERE schemaname = 'public'
AND tablename = 'lr_audit'
ORDER BY pubname;预期结果变为:
ALTER PUBLICATION
pubname | schemaname | tablename
----------+------------+-----------
pub_all | public | lr_audit
pub_core | public | lr_audit这说明“新表是否自动进入复制范围”取决于 Publication 的定义方式,而不是表创建时间。
让已有订阅看到范围变化
Publication 增加新表后,已经存在的 Subscription 不会仅凭发布端范围变化就自动完成新表注册,需要在订阅端刷新 Publication。下面是片段示例,前提是订阅端已经存在名为 sub_migration 的订阅。
ALTER SUBSCRIPTION sub_migration
REFRESH PUBLICATION WITH (copy_data = true);预期输出:
ALTER SUBSCRIPTIONcopy_data = true 会为新加入订阅的表执行初始数据复制;如果迁移流程已经用其他方式装载过基线数据,可评估使用 copy_data = false,避免重复复制。对于低停机迁移,显式表集合更利于控制切换范围;需要持续自动纳入未来表时,再考虑 FOR ALL TABLES。