Allow TRUNCATE command to truncate foreign tables.
authorFujii Masao <fujii@postgresql.org>
Thu, 8 Apr 2021 11:56:08 +0000 (20:56 +0900)
committerFujii Masao <fujii@postgresql.org>
Thu, 8 Apr 2021 11:56:08 +0000 (20:56 +0900)
commit8ff1c94649f5c9184ac5f07981d8aea9dfd7ac19
tree351ccf9b3a7e2b3256684ba7f73a80b3eac220b1
parent50e17ad281b8d1c1b410c9833955bc80fbad4078
Allow TRUNCATE command to truncate foreign tables.

This commit introduces new foreign data wrapper API for TRUNCATE.
It extends TRUNCATE command so that it accepts foreign tables as
the targets to truncate and invokes that API. Also it extends postgres_fdw
so that it can issue TRUNCATE command to foreign servers, by adding
new routine for that TRUNCATE API.

The information about options specified in TRUNCATE command, e.g.,
ONLY, CACADE, etc is passed to FDW via API. The list of foreign tables to
truncate is also passed to FDW. FDW truncates the foreign data sources
that the passed foreign tables specify, based on those information.
For example, postgres_fdw constructs TRUNCATE command using them
and issues it to the foreign server.

For performance, TRUNCATE command invokes the FDW routine for
TRUNCATE once per foreign server that foreign tables to truncate belong to.

Author: Kazutaka Onishi, Kohei KaiGai, slightly modified by Fujii Masao
Reviewed-by: Bharath Rupireddy, Michael Paquier, Zhihong Yu, Alvaro Herrera, Stephen Frost, Ashutosh Bapat, Amit Langote, Daniel Gustafsson, Ibrar Ahmed, Fujii Masao
Discussion: https://postgr.es/m/CAOP8fzb_gkReLput7OvOK+8NHgw-RKqNv59vem7=524krQTcWA@mail.gmail.com
Discussion: https://postgr.es/m/CAJuF6cMWDDqU-vn_knZgma+2GMaout68YUgn1uyDnexRhqqM5Q@mail.gmail.com
17 files changed:
contrib/postgres_fdw/connection.c
contrib/postgres_fdw/deparse.c
contrib/postgres_fdw/expected/postgres_fdw.out
contrib/postgres_fdw/option.c
contrib/postgres_fdw/postgres_fdw.c
contrib/postgres_fdw/postgres_fdw.h
contrib/postgres_fdw/sql/postgres_fdw.sql
doc/src/sgml/fdwhandler.sgml
doc/src/sgml/postgres-fdw.sgml
doc/src/sgml/ref/truncate.sgml
src/backend/commands/tablecmds.c
src/backend/replication/logical/worker.c
src/include/commands/tablecmds.h
src/include/foreign/fdwapi.h
src/include/utils/rel.h
src/test/regress/expected/foreign_data.out
src/tools/pgindent/typedefs.list