Refactor COPY TO to use format callback functions.

Masahiko Sawada <msawada@postgresql.org>

Commit: 2e4127b6d2d8f3a9d67a21d1905703d5be46970c
Author: Masahiko Sawada <msawada@postgresql.org>
Date: 2025-02-27T23:03:52Z
Releases: 18.0
Refactor COPY TO to use format callback functions.

This commit introduces a new CopyToRoutine struct, which is a set of
callback routines to copy tuples in a specific format. It also makes
the existing formats (text, CSV, and binary) utilize these format
callbacks.

This change is a preliminary step towards making the COPY TO command
extensible in terms of output formats.

Additionally, this refactoring contributes to a performance
improvement by reducing the number of "if" branches that need to be
checked on a per-row basis when sending field representations in text
or CSV mode. The performance benchmark results showed ~5% performance
gain in text or CSV mode.

Author: Sutou Kouhei <kou@clear-code.com>
Reviewed-by: Masahiko Sawada <sawada.mshk@gmail.com>
Reviewed-by: Michael Paquier <michael@paquier.xyz>
Reviewed-by: Andres Freund <andres@anarazel.de>
Reviewed-by: Tomas Vondra <tomas.vondra@enterprisedb.com>
Reviewed-by: Junwang Zhao <zhjwpku@gmail.com>
Discussion: https://postgr.es/m/20231204.153548.2126325458835528809.kou@clear-code.com

Files

PathChange+/−
src/backend/commands/copyto.c modified +297 −141
src/include/commands/copyapi.h added +57 −0
src/tools/pgindent/typedefs.list modified +1 −0

Discussion