출판사 기능

create_publisher

각 데이터베이스에서 여러 개의 출판물을 만들어서 다른 구독자에게 변경 사항을 게시할 수 있습니다.

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

각 데이터베이스에서 실행되는 출판물의 수를 나열합니다.

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

출판물의 정의를 수정합니다.

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

사용하지 않는 출판물을 삭제/제거하십시오.

Usage:
    exampledb=# drop publication my_publication_new;
    DROP PUBLICATION

다음 사항을 전제로 고려하십시오

1. 외부(출판사) 설정 PostgreSQL wal_level=logical.
2. 복제를 위해 선택된 모든 테이블에는 기본 키가 포함되어 있거나 REPLICA IDENTITY 설정되어 있어야 합니다.
3. 외부(출판사) PostgreSQL 에는 PostgreSQL 특권 REPLICATION 권한을 가진 복제 사용자가 있어야 하며, 이 사용자는 데이터베이스에 대한 SELECT 및 USAGE 권한과 함께 REPLICATION 권한을 가지고 있어야 합니다.
4. 복제 대상인 PostgreSQL 에는 TLS / SSL 기능이 활성화되어 있어야 합니다.
5. 행 수준 보안이 활성화된 경우, 외부(출판사) PostgreSQL 복제 사용자에게 BYPASSRLS 권한을 부여합니다.

PostgreSQL 문서에 설명된 바와 같이, 논리적 복제에는 본질적인 한계와 몇 가지 제약 사항이 있습니다. 논리적 복제가 사용 사례에 적합한지 결정하기 전에 이 내용을 검토하십시오.

Subscriber 함수

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

이 함수는 구독의 슬롯 이름을 NONE으로 설정하는 데 사용됩니다. 이는 원격 복제 슬롯을 삭제할 수 없거나 존재하지 않거나 존재한 적이 없는 구독을 삭제하기 위해 필요합니다.

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

이 함수는 테이블 추가 또는 삭제와 같이 공개자가 변경된 후 구독자의 구독을 새로 고치는 데 사용됩니다.

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

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