Section courante

A propos

Section administrative du site

CREATE SUBSCRIPTION

Crée un abonnement
PostgreSQL

Syntaxe

CREATE SUBSCRIPTION subscription_name CONNECTION 'conninfo' PUBLICATION publication_name [, ...] [ WITH ( subscription_parameter [= value] [, ... ] ) ]

Paramètres

Nom Description
subscription_name Ce paramètre permet d'indiquer le nom du nouvel abonnement.
CONNECTION 'conninfo' Ce paramètre permet d'indiquer la chaîne de caractères de connexion à l'éditeur.
PUBLICATION publication_name Ce paramètre permet d'indiquer les noms des publications sur l'éditeur auquel s'abonner.
WITH ( subscription_parameter [= value] [, ... ] ) Ce paramètre permet d'indiquer les paramètres facultatifs d'un abonnement. Les paramètres suivants sont pris en charge :
Paramètres Description
copy_data (boolean) Ce paramètre permet d'indiquer si les données existantes dans les publications auxquelles vous êtes abonné doivent être copiées une fois la réplication démarrée. La valeur par défaut est true.
create_slot (boolean) Ce paramètre permet d'indiquer si la commande doit créer l'emplacement de réplication sur l'éditeur. La valeur par défaut est true.
enabled (boolean) Ce paramètre permet d'indiquer si l'abonnement doit être activement répliqué ou s'il doit être simplement configuré mais pas encore démarré. La valeur par défaut est true.
slot_name (string) Ce paramètre permet d'indiquer le nom de la fente de réplication à utiliser. Le comportement par défaut consiste à utiliser le nom de l'abonnement pour le nom de l'emplacement. Lorsque slot_name est défini sur NONE, aucun emplacement de réplication n'est associé à l'abonnement. Cela peut être utilisé si la fente de réplication sera créé plus tard manuellement. De tels abonnements doivent également avoir à la fois enabled et create_slot défini sur false.
synchronous_commit (enum) Ce paramètre permet d'indiquer que la valeur de ce paramètre remplace le paramètre synchronous_commit. La valeur par défaut est désactivée. Il est sûr d'utiliser off pour la réplication logique : si l'abonné perd des transactions en raison d'une synchronisation manquante, les données seront à nouveau envoyées par l'éditeur. Un paramètre différent peut être approprié lors de la réplication logique synchronisé. Les agents de réplication logique signalent les positions des écritures et des vidages à l'éditeur, et lors de l'utilisation de la réplication synchronisé, l'éditeur attendra le vidage actuel. Cela signifie que la définition de synchronous_commit pour l'abonné sur off lorsque l'abonnement est utilisé pour la réplication synchrone peut augmenter la latence pour COMMIT sur l'éditeur. Dans ce scénario, il peut être avantageux de définir synchronous_commit sur local ou supérieur.
connect (boolean) Ce paramètre permet d'indiquer si CREATE SUBSCRIPTION doit se connecter à l'éditeur. Le définir sur false changera les valeurs par défaut de enabled, create_slot et copy_data en false. Il n'est pas permis de combiner connect défini sur false et enabled, create_slot ou copy_data défini sur true. Étant donné qu'aucune connexion n'est établie lorsque cette option est définie sur false, les tables ne sont pas abonnées et, une fois l'abonnement activé, rien ne sera répliqué. Il est nécessaire d'exécuter ALTER SUBSCRIPTION ... REFRESH PUBLICATION pour que les tables soient souscrites.

Description

Cette instruction permet de définir un nouvel abonnement.



Dernière mise à jour : Jeudi, le 14 Octobre 2021