diff options
| author | Peter Eisentraut | 2017-06-09 21:11:46 +0000 |
|---|---|---|
| committer | Peter Eisentraut | 2017-06-09 21:14:06 +0000 |
| commit | 0933fcee9851eb2afcd41db1ee4425153f4cbdd3 (patch) | |
| tree | 698c8c42004fd5b3925d4db36e40a5f9dcba9cfb | |
| parent | 493490cbcb19c5232038827b114a4ec72aa3e731 (diff) | |
doc: Document that subscriptions to same server might hang
| -rw-r--r-- | doc/src/sgml/ref/create_subscription.sgml | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/create_subscription.sgml b/doc/src/sgml/ref/create_subscription.sgml index 2c91eb6f50..dd5eda043a 100644 --- a/doc/src/sgml/ref/create_subscription.sgml +++ b/doc/src/sgml/ref/create_subscription.sgml @@ -226,6 +226,19 @@ CREATE SUBSCRIPTION <replaceable class="PARAMETER">subscription_name</replaceabl how to configure access control between the subscription and the publication instance. </para> + + <para> + Creating a subscription that connects to the same database cluster (for + example, to replicate between databases in the same cluster or to replicate + within the same database) will only succeed if the replication slot is not + created as part of the same command. Otherwise, the <command>CREATE + SUBSCRIPTION</command> call will hang. To make this work, create the + replication slot separately (using the + function <function>pg_create_logical_replication_slot</function> with the + plugin name <literal>pgoutput</literal>) and create the subscription using + the parameter <literal>create_slot = false</literal>. This is an + implementation restriction that might be lifted in a future release. + </para> </refsect1> <refsect1> |