更新时间:2024-07-02 GMT+08:00

逻辑订阅故障转移(Failover Slot)

使用场景

RDS for PostgreSQL的逻辑订阅故障转移(Failover Slot)功能用来将那些指定为failover slot的逻辑复制槽信息从主实例同步到备实例,当主备切换之后逻辑订阅能够继续进行,实现逻辑复制槽的故障转移。

当用户使用逻辑复制时,由于slot信息不会随着主备切换转移到新的主实例上,一旦实例发生主备切换,逻辑订阅就会断开,此时除非手动重新创建slot,否则逻辑订阅无法重新连接。RDS for PostgreSQL的Failover Slot功能可以将所有的logical slot从主实例同步到备实例,避免主备切换后逻辑订阅断开。

注意事项

  • 该功能针对RDS for PostgreSQL 12.6及以上的小版本、RDS for PostgreSQL 13及以上版本的所有小版本。
  • 当前只支持logical slot的故障转移,physical slot暂不支持。
  • 该功能由于引入新的日志类型,因此一旦使用了该功能,通过备份文件恢复到新实例时,会保留旧的slot信息,恢复到新实例后需要手动删除slot信息。

使用方法

在发布端执行如下SQL,创建一个Failover Slot:

表1 命令及参数说明

版本

命令

参数说明

PostgreSQL12和PostgreSQL13版本

SELECT * FROM pg_create_logical_replication_slot('slotname', 'pgoutput', false, true);

  • slotname表示logical slot的名称。
  • pgoutput表示plugin的名称,也可以更改为其他支持的插件。
  • 第三个参数(例如false),表示该slot是否为临时slot。
  • 第四个参数(例如true),表示该slot是否为Failover Slot。

PostgreSQL14及以上版本

SELECT * FROM pg_create_logical_replication_slot('slotname', 'pgoutput', false, false, true);

  • slotname表示logical slot的名称。
  • pgoutput表示plugin的名称,也可以更改为其他支持的插件。
  • 第三个参数(例如false),表示该slot是否为临时slot。
  • 第四个参数(例如true),表示是否启动两阶段提交选项。
  • 第五个参数(例如true),表示该复制槽是否为Failover slot。

因此,如果要创建一个Failover Slot,在第三个参数临时slot字段必须为false,最后一个参数必须为true。如果最后一个参数省略不写,则创建的是非Failover Slot。

查看方法

在发布端执行如下SQL,查询当前数据库的复制槽信息。

select * from pg_get_replication_slots();

  • 查看“failover”字段,如果值为“true”,表示该复制槽为Failover Slot。
  • 如果没有“failover”字段或该字段值为“false”,说明该复制槽不是Failover Slot。

逻辑订阅完整使用示例

  • 发布端创建表

    create table tableName(id int primary key, num int);

  • 发布端创建发布

    create publication pubName for table tableName;

  • 发布端创建一个Failover Slot(若为PostgreSQL12或13版本,则去掉第四个参数false)

    SELECT * FROM pg_create_logical_replication_slot('slotname', 'pgoutput', false, false, true);

  • 发布端插入数据

    insert into tableName values(1,1);

    insert into tableName values(2,2);

  • 订阅端创建表

    create table tableName (id int primary key, num int);

  • 订阅端创建订阅,指定创建的Failover Slot名称

    create subscription subName connection 'host=192.168.0.10 dbname=postgres user=root port=5432 password=xxxxxxx' publication pubName with(copy_data=true,create_slot=false,slot_name= slotname);

  • 订阅端查询数据,验证数据是否订阅到

    select * from tableName;

  • 主备切换

    发布端继续插入数据,在订阅端查看,逻辑订阅不会断开。