Commit 15fcd33e authored by Etsuro Fujita's avatar Etsuro Fujita

Doc: Update documentation for asynchronous execution.

Add a note of caution on the performance of asynchronous execution by
postgres_fdw.  Follow-up for commit 27e1f145.

Stephen Frost, a little bit expanded by me.

Discussion: https://postgr.es/m/20210506171224.GV20766%40tamriel.snowman.net
parent 07af57db
......@@ -401,6 +401,16 @@ OPTIONS (ADD password_required 'false');
A table-level option overrides a server-level option.
The default is <literal>false</literal>.
</para>
<para>
In order to ensure that the data being returned from a foreign server
is consistent, <filename>postgres_fdw</filename> will only open one
connection for a given foreign server and will run all queries against
that server sequentially even if there are multiple foreign tables
involved, unless those tables are subject to different user mappings.
In such a case, it may be more performant to disable this option to
eliminate the overhead associated with running queries asynchronously.
</para>
</listitem>
</varlistentry>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment