From cadead6c3c8ed81e09a3cb5101ff453758412f54 Mon Sep 17 00:00:00 2001 From: Alvaro Herrera Date: Sun, 10 Mar 2019 19:45:29 -0300 Subject: [PATCH] Fix documentation on partitioning vs. foreign tables 1. The PARTITION OF clause of CREATE FOREIGN TABLE was not explained in the CREATE FOREIGN TABLE reference page. Add it. (Postgres 10 onwards) 2. The limitation that tuple routing cannot target partitions that are foreign tables was not documented clearly enough. Improve wording. (Postgres 10 onwards) 3. The UPDATE tuple re-routing concurrency behavior was explained in the DDL chapter, which doesn't seem the right place. Move it to the UPDATE reference page instead. (Postgres 11 onwards). Authors: Amit Langote, David Rowley. Reviewed-by: Etsuro Fujita. Reported-by: Derek Hans Discussion: https://postgr.es/m/CAGrP7a3Xc1Qy_B2WJcgAD8uQTS_NDcJn06O5mtS_Ne1nYhBsyw@mail.gmail.com --- doc/src/sgml/ref/create_foreign_table.sgml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/src/sgml/ref/create_foreign_table.sgml b/doc/src/sgml/ref/create_foreign_table.sgml index 065c982082d..38b18a02bb3 100644 --- a/doc/src/sgml/ref/create_foreign_table.sgml +++ b/doc/src/sgml/ref/create_foreign_table.sgml @@ -160,6 +160,18 @@ CHECK ( expression ) [ NO INHERIT ] + + PARTITION OF parent_table FOR VALUES partition_bound_spec + + + This form can be used to create the foreign table as partition of + the given parent table with specified partition bound values. + See the similar form of + for more details. + + + + CONSTRAINT constraint_name @@ -308,6 +320,11 @@ CHECK ( expression ) [ NO INHERIT ] responsibility to ensure that the constraint definition matches reality. + + + Although foreign tables can be specified as partitions, routing of tuples + to foreign-table partitions is not supported. +