aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/src/sgml/fdwhandler.sgml15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/src/sgml/fdwhandler.sgml b/doc/src/sgml/fdwhandler.sgml
index 2c07a866372..eb92253e387 100644
--- a/doc/src/sgml/fdwhandler.sgml
+++ b/doc/src/sgml/fdwhandler.sgml
@@ -594,6 +594,14 @@ ExecForeignInsert(EState *estate,
</para>
<para>
+ Note that this function is also called when inserting routed tuples into
+ a foreign-table partition or executing <command>COPY FROM</command> on
+ a foreign table, in which case it is called in a different way than it
+ is in the <command>INSERT</command> case. See the callback functions
+ described below that allow the FDW to support that.
+ </para>
+
+ <para>
<programlisting>
TupleTableSlot *
ExecForeignUpdate(EState *estate,
@@ -752,6 +760,13 @@ BeginForeignInsert(ModifyTableState *mtstate,
</para>
<para>
+ Note that if the FDW does not support routable foreign-table partitions
+ and/or executing <command>COPY FROM</command> on foreign tables, this
+ function or <function>ExecForeignInsert</function> subsequently called
+ must throw error as needed.
+ </para>
+
+ <para>
<programlisting>
void
EndForeignInsert(EState *estate,