database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-04-25 21:42:33 +03:00
Code

CREATE PUBLICATION ref: Minor tweaks to row filters

Browse Source 
Prompted by a complaint from Justin Pryzby.

Reviewed-by: Amit Kapila <amit.kapila16@gmail.com>
Discussion: https://postgr.es/m/20220414003301.GT26620@telsasoft.com
This commit is contained in:
Alvaro Herrera 2022-04-21 18:57:40 +02:00
parent 40eba064b2
commit bb85eec6fe
No known key found for this signature in database
GPG Key ID: 1C20ACB9D5C564AE
1 changed files with 20 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/src/sgml/ref/create_publication.sgml
View File

@ -79,7 +79,8 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</para> </para>
<para> <para>
If the optional <literal>WHERE</literal> clause is specified, rows for If the optional <literal>WHERE</literal> clause is specified, it defines a
<firstterm>row filter</firstterm> expression. Rows for
which the <replaceable class="parameter">expression</replaceable> which the <replaceable class="parameter">expression</replaceable>
evaluates to false or null will not be published. Note that parentheses evaluates to false or null will not be published. Note that parentheses
are required around the expression. It has no effect on are required around the expression. It has no effect on
@ -192,6 +193,11 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
consisting of a different set of partitions. consisting of a different set of partitions.
</para> </para>
<para>
This parameter also affects how row filters and column lists are
chosen for partitions; see below for details.
</para>
<para> <para>
If this is enabled, <literal>TRUNCATE</literal> operations performed If this is enabled, <literal>TRUNCATE</literal> operations performed
directly on partitions are not replicated. directly on partitions are not replicated.
@ -241,21 +247,28 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</para> </para>
<para> <para>
A <literal>WHERE</literal> (i.e. row filter) expression must contain only A row filter expression (i.e., the <literal>WHERE</literal> clause) must contain only
columns that are covered by the <literal>REPLICA IDENTITY</literal>, in columns that are covered by the <literal>REPLICA IDENTITY</literal>, in
order for <command>UPDATE</command> and <command>DELETE</command> operations order for <command>UPDATE</command> and <command>DELETE</command> operations
to be published. For publication of <command>INSERT</command> operations, to be published. For publication of <command>INSERT</command> operations,
any column may be used in the <literal>WHERE</literal> expression. The any column may be used in the <literal>WHERE</literal> expression. The
<literal>WHERE</literal> clause allows simple expressions that don't have row filter allows simple expressions that don't have
user-defined functions, user-defined operators, user-defined types, user-defined functions, user-defined operators, user-defined types,
user-defined collations, non-immutable built-in functions, or references to user-defined collations, non-immutable built-in functions, or references to
system columns. system columns.
If your publication contains a partitioned table, the publication parameter </para>
<literal>publish_via_partition_root</literal> determines if it uses the
partition's row filter (if the parameter is false, the default) or the root <para>
partitioned table's row filter. For published partitioned tables, the row filter for each
partition is taken from the published partitioned table if the
publication parameter <literal>publish_via_partition_root</literal> is true,
or from the partition itself if it is false (the default).
See <xref linkend="logical-replication-row-filter"/> for details about row See <xref linkend="logical-replication-row-filter"/> for details about row
filters. filters.
Similarly, for published partitioned tables, the column list for each
partition is taken from the published partitioned table if the
publication parameter <literal>publish_via_partition_root</literal> is true,
or from the partition itself if it is false.
</para> </para>
<para> <para>