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。

sql
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;

预期输出:

text
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。

sql
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:

text
CREATE TABLE
 pubname | schemaname | tablename
---------+------------+-----------
 pub_all | public     | lr_audit

如果希望把新表加入显式表集合,需要主动修改 Publication。

sql
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;

预期结果变为:

text
ALTER PUBLICATION
 pubname  | schemaname | tablename
----------+------------+-----------
 pub_all  | public     | lr_audit
 pub_core | public     | lr_audit

这说明“新表是否自动进入复制范围”取决于 Publication 的定义方式,而不是表创建时间。

让已有订阅看到范围变化

Publication 增加新表后,已经存在的 Subscription 不会仅凭发布端范围变化就自动完成新表注册,需要在订阅端刷新 Publication。下面是片段示例,前提是订阅端已经存在名为 sub_migration 的订阅。

sql
ALTER SUBSCRIPTION sub_migration
REFRESH PUBLICATION WITH (copy_data = true);

预期输出:

text
ALTER SUBSCRIPTION

copy_data = true 会为新加入订阅的表执行初始数据复制;如果迁移流程已经用其他方式装载过基线数据,可评估使用 copy_data = false,避免重复复制。对于低停机迁移,显式表集合更利于控制切换范围;需要持续自动纳入未来表时,再考虑 FOR ALL TABLES。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 Publication 并选择对象

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通