aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorDaniel Gustafsson <dgustafsson@postgresql.org>2023-09-21 13:53:07 +0200
committerDaniel Gustafsson <dgustafsson@postgresql.org>2023-09-21 13:53:07 +0200
commitcca97ce6a6653df7f4ec71ecd54944cc9a6c4c16 (patch)
tree319b047b066b90da93e6db12deadc3cf1ae28d7d /doc/src
parentc621467d2bc6435d07db4471998ca9c9f0c57777 (diff)
downloadpostgresql-cca97ce6a6653df7f4ec71ecd54944cc9a6c4c16.tar.gz
postgresql-cca97ce6a6653df7f4ec71ecd54944cc9a6c4c16.zip
Allow dbname in pg_basebackup/pg_receivewal connstring
As physical replication work at the cluster level and not database level, any dbname in the connection string is ignored. Proxies and middleware used in connecting to the cluster might however need to know the dbname in order to make the correct routing decision for the connection. With this the startup packet will include the dbname parameter. Author: Jelte Fennema-Nio <me@jeltef.nl> Reviewed-by: Tristen Raab <tristen.raab@highgo.ca> Reviewed-by: Jim Jones <jim.jones@uni-muenster.de> Discussion: https://postgr.es/m/CAGECzQTw-dZkVT_RELRzfWRzY714-VaTjoBATYfZq93R8C-auA@mail.gmail.com
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/pg_basebackup.sgml5
-rw-r--r--doc/src/sgml/ref/pg_receivewal.sgml7
2 files changed, 9 insertions, 3 deletions
diff --git a/doc/src/sgml/ref/pg_basebackup.sgml b/doc/src/sgml/ref/pg_basebackup.sgml
index d2b8ddd200c..344de921e4b 100644
--- a/doc/src/sgml/ref/pg_basebackup.sgml
+++ b/doc/src/sgml/ref/pg_basebackup.sgml
@@ -778,7 +778,10 @@ PostgreSQL documentation
The option is called <literal>--dbname</literal> for consistency with other
client applications, but because <application>pg_basebackup</application>
doesn't connect to any particular database in the cluster, any database
- name in the connection string will be ignored.
+ name in the connection string will be ignored
+ by <productname>PostgreSQL</productname>. Middleware, or proxies, used in
+ connecting to <productname>PostgreSQL</productname> might however
+ utilize the value.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/ref/pg_receivewal.sgml b/doc/src/sgml/ref/pg_receivewal.sgml
index cecc7daec97..798b972d3cc 100644
--- a/doc/src/sgml/ref/pg_receivewal.sgml
+++ b/doc/src/sgml/ref/pg_receivewal.sgml
@@ -316,8 +316,11 @@ PostgreSQL documentation
<para>
The option is called <literal>--dbname</literal> for consistency with other
client applications, but because <application>pg_receivewal</application>
- doesn't connect to any particular database in the cluster, database
- name in the connection string will be ignored.
+ doesn't connect to any particular database in the cluster, any database
+ name in the connection string will be ignored by
+ <productname>PostgreSQL</productname>. Middleware, or proxies, used in
+ connecting to <productname>PostgreSQL</productname> might however
+ utilize the value.
</para>
</listitem>
</varlistentry>