G.5. pgpro_logical_slot — управление слотами логической репликации #
G.5.1. Обзор #
pgpro_logical_slot — это расширение Postgres Pro Shardman для управления слотами логической репликации. С помощью расширения можно создать слот в прошлом для указанного LSN. Это применимо, когда нужно восстановить утерянный слот логической репликации.
У расширения pgpro_logical_slot есть следующие ограничения:
Стандартные ограничения создания слота логической репликации, т.е. для параметра wal_level должно быть задано значение
logicalс моментаrestart_lsn.Сегменты WAL с момента
restart_lsnдо текущего LSN должны присутствовать на физическом узле.Во временном интервале между
restart_lsnи созданием слота логической репликации структура реплицируемой таблицы должна оставаться неизменной.При создании слота логической репликации pgpro_logical_slot ищет точку согласованности — подходящий начальный LSN, откуда можно безопасно начать логическое декодирование. Чтобы её найти, необходимо, чтобы на узле в интервале между
restart_lsnи созданием слота логической репликации имелись контрольные точки. После создания слота необходимо убедиться, что текущий начальный LSN, возвращённый функцией pgpro_logical_slot.pgpro_create_logical_replication_slot, соответствует вашим требованиям.
G.5.2. Установка #
Расширение pgpro_logical_slot поставляется вместе с Postgres Pro Shardman в виде отдельного пакета pgpro-logical-slot-sdm-18. За подробной инструкцией по установке обратитесь к Главе 16. После установки Postgres Pro Shardman создайте расширение pgpro_logical_slot:
CREATE EXTENSION pgpro_logical_slot;
G.5.3. Функции #
pgpro_logical_slot.pgpro_create_logical_replication_slot (#имя_слотаname,имя_модуляname,temporaryboolean,twophaseboolean,restart_lsnpg_lsn) returns record (имя_слотаname,lsnpg_lsn)Создаёт слот логической репликации с
restart_lsnв прошлом. Функция принимает следующие параметры:имя_слота: имя создаваемого слота логической репликации.имя_модуля: имя модуля вывода.temporary: необязательный параметр, который определяет, будет ли слот постоянно храниться на диске. Если задано значениеtrue, слот не хранится на диске и используется только в текущем сеансе. Временные слоты также освобождаются при любой ошибке.twophase: необязательный параметр, который определяет, включить ли декодирование подготовленных транзакций для этого слота. Если задано значениеtrue, декодирование включено.restart_lsn: значениеrestart_lsnпоследнего известного работающего состояния слота логической репликации или, если слот создаётся впервые, требуемого состояния слота физической репликации.
Функция возвращает запись, содержащую имя слота и значение начального LSN, который отличается от
restart_lsnи с которого начинается логическая репликация. Все транзакции, зафиксированные после этого LSN, будут реплицированы.Например:
postgres=# SELECT pgpro_logical_slot.pgpro_create_logical_replication_slot('s2', 'test_decoding', false, false, '0/17C8520'::pg_lsn); pgpro_create_logical_replication_slot --------------------------------------- (s2,0/17C8568) (1 row)Функция
pgpro_logical_slot.pgpro_create_logical_replication_slotне проверяет наличие исторических кортежей или необходимых файлов WAL. После создания слота можно выполнить функциюpg_logical_slot_peek_changes, чтобы убедиться, что слот может быть использован для декодирования с LSN в прошлом. Например:postgres=# SELECT count(*) from pg_logical_slot_peek_changes('s2', null, null); count -------- 160055 (1 row)