Commit90fca7a

Etsuro Fujita

committed

Add FDW documentation notes about insert and update tuple routing and COPY.

Author: Laurenz Albe and Etsuro FujitaReviewed-by: Laurenz Albe and Amit LangoteBackpatch-through: 11 where support for that by FDWs was addedDiscussion:https://postgr.es/m/bf36a0288e8f31b4f2f40952e225bf892dc1ffc5.camel@cybertec.at

1 parenta9ce839 commit90fca7aCopy full SHA for 90fca7a

File tree

+15

-0

lines changed

+15

-0

lines changed

Lines changed: 15 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -593,6 +593,14 @@ ExecForeignInsert(EState *estate,`
`593`	`593`	`with an error message.`
`594`	`594`	`</para>`
`595`	`595`
	`596`	`+ <para>`
	`597`	`+ Note that this function is also called when inserting routed tuples into`
	`598`	`+ a foreign-table partition or executing <command>COPY FROM</command> on`
	`599`	`+ a foreign table, in which case it is called in a different way than it`
	`600`	`+ is in the <command>INSERT</command> case. See the callback functions`
	`601`	`+ described below that allow the FDW to support that.`
	`602`	`+ </para>`
	`603`	`+`
`596`	`604`	`<para>`
`597`	`605`	`<programlisting>`
`598`	`606`	`TupleTableSlot *`
`@@ -751,6 +759,13 @@ BeginForeignInsert(ModifyTableState *mtstate,`
`751`	`759`	`<literal>NULL</literal>, no action is taken for the initialization.`
`752`	`760`	`</para>`
`753`	`761`
	`762`	`+ <para>`
	`763`	`+ Note that if the FDW does not support routable foreign-table partitions`
	`764`	`+ and/or executing <command>COPY FROM</command> on foreign tables, this`
	`765`	`+ function or <function>ExecForeignInsert</function> subsequently called`
	`766`	`+ must throw error as needed.`
	`767`	`+ </para>`
	`768`	`+`
`754`	`769`	`<para>`
`755`	`770`	`<programlisting>`
`756`	`771`	`void`

Comments

(0)