Description

CREATE PUBLICATION ajoute une nouvelle publication dans la base courante. Le nom de la publication doit être différent du nom de toutes les autres publications existante au sein de la base courante.

Une publication est essentiellement un groupe de table dont les changement de données sont destinés à être répliqué grâce à la réplication logique. Voir Section 31.1 pour les détails de comment les publications participent à la mise en place de la réplication logique.

Paramètres

Notes

Si les clauses FOR TABLE, FOR ALL TABLES ou FOR TABLES IN SCHEMA ne sont pas passées, alors la publication commence avec un ensemble vide de tables. C'est utile si les tables ou schémas sont à ajouter ultérieurement.

La création d'une publication ne démarre pas la réplication. Cela définit uniquement un regroupement ainsi qu'un filtre logique pour les futurs souscripteurs.

Pour créer une publication, l'utilisateur lançant la commande doit avec le droit CREATE pour la base de données courante. (Bien entendu, les superutilisateurs contournent cette vérification.)

Pour ajouter une table à une publication, l'utilisateur lançant la commande doit avoir les droits de propriétaire de la table. Les clauses FOR ALL TABLES et FOR TABLES IN SCHEMA nécessitent d'être superutilisateur pour pouvoir les utiliser.

Les tables ajoutées à une publication qui publie les opérations UPDATE et/ou DELETE doivent avoir REPLICA IDENTITY défini. Autrement ces opérations seront interdites sur ces tables.

Toute liste de colonnes doit inclure les colonnes REPLICA IDENTITY dans l'ordre pour la publication d'opérations UPDATE ou DELETE. Il n'y a pas des restrictions de listes de colonnes si la publication publie seulement des opérations INSERT.

Une expression de filtre par lignes (par exemple la clause WHERE) doit uniquement contenir les colonnes couvertes par REPLICA IDENTITY, pour que les opérations UPDATE et DELETE soient publiées. Pour la publication des opérations INSERT, toute colonne peut être utilisée dans l'expression WHERE. Le filtre de lignes autorise des expressions simples qui n'ont pas de fonctions définies par l'utilisateur, d'opérateurs définis par l'utilisateur, de types définis par l'utilisateur, de collations définis par l'utilisateur, de fonctions internes non immutables, ou de références à des colonnes systèmes.

Le filtre de lignes sur une table devient redondant si FOR TABLES IN SCHEMA est indiqué et que la table appartient au schéma référencé.

Pour les tables partitionnées publiées, le filtre de lignes pour que partition est pris de la table partitionnée publiée si le paramètre de publication publish_via_partition_root vaut true ou à partir de la partition elle-même s'il vaut false (valeur par défaut). Voir Section 31.3 pour les détails sur les filtres de lignes. De façon similaire, pour les tables partitionnées publiées, la liste de colonnes pour chaque partition est prise de la table partitionnée publiée si le paramètre de publication publish_via_partition_root vaut true, ou à partir de la partition elle-même si le paramètre vaut false.

Pour une commande INSERT ... ON CONFLICT, la publication publiera l'opération qui résulte de la commande. Ainsi, en fonction du résultat, cela pourrait être publiée comme un INSERT ou un UPDATE, ou cela pourrait ne pas être publié du tout.

Pour une commande MERGE, la publication publiera un INSERT, UPDATE ou DELETE pour chaque ligne insérée, mise à jour ou supprimée.

ATTACH-er une table dans un arbre de partition dont la racine est publiée en utilisant une publication ayant publish_via_partition_root configuré to true ne résulte pas en la réplication du contenu existant de la table.

Les commandes COPY ... FROM sont publiées comme des opérations INSERT.

Les opérations DDL ne sont pas publiées.

L'expression de la clause WHERE est exécutée avec le rôle utilisé pour la connexion de réplication.

Exemples

Créer une publication qui publie tous les changements sur deux tables :

CREATE PUBLICATION mypublication FOR TABLE users, departments;
   

Créer une publication qui publie tous les changements des départements actifs :

CREATE PUBLICATION active_departments FOR TABLE departments WHERE (active IS TRUE);

Créer une publication qui publie tous les changements sur toutes les tables :

CREATE PUBLICATION alltables FOR ALL TABLES;
   

Créer une publication qui ne publie que les opérations d'INSERT sur une table :

CREATE PUBLICATION insert_only FOR TABLE mydata
    WITH (publish = 'insert');

Créer une publication qui publie tous les changements des tables users, departments et tous les changements pour toutes les tables présentes dans le schéma production :

CREATE PUBLICATION production_publication FOR TABLE users, departments, TABLES IN SCHEMA production;

Créer une publication qui publie tous les changements pour toutes les tables présentes dans les schémas marketing et sales :

CREATE PUBLICATION sales_publication FOR TABLES IN SCHEMA marketing, sales;

Créer une publication qui publie tous les changements pour la table users, mais réplique uniquement les colonnes user_id et firstname :

CREATE PUBLICATION users_filtered FOR TABLE users (user_id, firstname);
   

Compatibilité

CREATE PUBLICATION est une extension PostgreSQL au langage SQL.

Voir aussi