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, temporary boolean, twophase boolean, restart_lsn pg_lsn) returns record (имя_слота name, lsn pg_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)
FAQ