Funções do editor

create_publisher

Em cada banco de dados, você pode criar várias publicações para publicar as alterações em um subcritério diferente.

Arguments:

    publisher_name               The Unique name of publisher.
    for table                    To publish single/list of tables
    for all table                To publish all tables, along with future tables.
    for all tables in schema     To publish all tables in schema, along wth future tables.

Usage:
    exampledb=> CREATE PUBLICATION my_publication;
    CREATE PUBLICATION

list_publisher

Liste o número de publicações em execução em cada banco de dados.

Usage:
   exampledb=# select * from pg_publication;
   oid  |    pubname     | pubowner | puballtables | pubinsert | pubupdate | pubdelete | pubtruncate
   -------+----------------+----------+--------------+-----------+-----------+-----------+-------------
   16401 | my_publication |       10 | t            | t         | t         | t         | t

alter_publisher

Modificar a definição da publicação.

Syntax:
ALTER PUBLICATION name ADD publication_object [, ...]
ALTER PUBLICATION name SET publication_object [, ...]
ALTER PUBLICATION name DROP publication_object [, ...]
ALTER PUBLICATION name SET ( publication_parameter [= value] [, ... ] )
ALTER PUBLICATION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER PUBLICATION name RENAME TO new_name


 Usage:
    exampledb=# ALTER PUBLICATION my_publication RENAME TO my_publication_new;
    ALTER PUBLICATION

drop_publisher

Solte/retire a publicação que não estiver sendo usada.

Usage:
    exampledb=# drop publication my_publication_new;
    DROP PUBLICATION

Considere o seguinte como pré-requisito:

1. Configurar o externo (editor) PostgreSQL wal_level=logical.
2. Todas as tabelas selecionadas para replicação precisam conter uma chave primária ou ter REPLICA IDENTITY definida.
3. Seu PostgreSQL externo (editor) precisa ter um usuário de replicação que tenha o privilégio PostgreSQL REPLICATION, e esse usuário precisa ter privilégios SELECT e USAGE nos bancos de dados, além de privilégios REPLICATION.
4. O servidor de dados ( PostgreSQL ) do qual você está replicando precisa ter o recurso " TLS " / " SSL " habilitado.
5. Fornecer privilégios BYPASSRLS ao usuário externo (editor) da replicação PostgreSQL, se a segurança de nível de linha estiver ativada.

Existem limitações inerentes e algumas restrições à replicação lógica descritas na documentação do PostgreSQL. Analise-os antes de decidir se a replicação lógica é apropriada para seu caso de uso.

Funções do assinante

create_subscription

Arguments:
    subscription_name   Unique name to create the subscription channel with
    host_ip             Publisher hostname or public IP address
    port                Port number publisher is running on
    password            Password of the `admin` user on the publisher
    username            `admin` user created on the publisher
    db_name             The name of the database to be replicated
    publisher_name      The name of publisher channel on the publisher

    These additional configuration options are only supported in PostgreSQL 17 and later.
    copy_data           The copy_data parameter (true or false, default: true)
                        determines whether the initial data from the publication
                        should be copied to the subscriber when the subscription
                        is created.
    origin              The origin parameter (ANY or NONE, default: NONE) allows
                        filtering of changes based on their origin. It helps exclude
                        or include changes coming from specific nodes in multi-node or
                        cascading replication setups.
    failover            The failover parameter (true or false, default: false) enables
                        support for automatic failover of the subscription between replicated
                        nodes, ensuring continuity during primary node transitions.

Usage:
    exampledb=> SELECT create_subscription('subs1','130.215.223.184','5432','password','admin','exampledb','my_publication');

    PostgreSQL 17 and later
    exampledb=> SELECT create_subscription('subs1','130.215.223.184','5432','password','admin','exampledb','my_publication'  'true',  'ANY' , 'true');

delete_subscription

Arguments:
    subscription_name   Name the subscription channel to delete
    db_name             The name of the replicated database

Usage:
exampledb=> SELECT delete_subscription('subs1', 'exampledb');

list_subscriptions

Arguments:
    None

Usage:
    exampledb=> SELECT * FROM list_subscriptions();

disable_subscription

Arguments:
    subscription_name   Name the subscription channel to disable
    db_name             The name of the replicated database

Usage:
    exampledb=> SELECT disable_subscription('subs1','exampledb');

enable_subscription

Arguments:
    subscription_name   Name the subscription channel to enable
    db_name             The name of the replicated database

Usage:
    exampledb=> SELECT enable_subscription('subs1','exampledb');

subscription_slot_none

Essa função é usada para definir o nome do slot de uma assinatura como NONE. Isso é necessário para excluir uma assinatura, de modo que um slot de replicação remota não possa ser descartado, não exista ou nunca tenha existido.

Arguments:
    subscription_name   Name the subscription channel to alter
    db_name             The name of the replicated database

Usage:
    exampledb=> SELECT subscription_slot_none('subs1','exampledb');

refresh_subscription

Essa função será usada para atualizar uma assinatura no assinante depois que forem feitas mudanças no publicador, como a inclusão ou a remoção de uma tabela.

Arguments:
    subscription_name   Name the subscription channel to refresh
    db_name             The name of the replicated database

Usage:
    exampledb=> SELECT refresh_subscription('subs1','exampledb');