]> git.ipfire.org Git - thirdparty/postgresql.git/commit
Use named boolean parameters for pg_get_*_ddl option arguments
authorAndrew Dunstan <andrew@dunslane.net>
Fri, 26 Jun 2026 12:00:39 +0000 (08:00 -0400)
committerAndrew Dunstan <andrew@dunslane.net>
Sun, 28 Jun 2026 14:45:26 +0000 (10:45 -0400)
commitd6ed87d19890b1cfa93d1f6e8957fa525834c0e2
treeff3125c3e70a65f8c444df745c701052f9e564c3
parent02f699c1416380c0411fbc0f53061f86b2f52ed3
Use named boolean parameters for pg_get_*_ddl option arguments

Replace the VARIADIC text[] alternating key/value option interface with
typed named boolean parameters for pg_get_role_ddl(), pg_get_tablespace_ddl(),
and pg_get_database_ddl(), as added by commit 4881981f920 and friends.
The new signatures are:

  pg_get_role_ddl(role regrole,
                  pretty boolean DEFAULT false,
                  memberships boolean DEFAULT true)

  pg_get_tablespace_ddl(tablespace oid/name,
                        pretty boolean DEFAULT false,
                        owner boolean DEFAULT true)

  pg_get_database_ddl(db regdatabase,
                      pretty boolean DEFAULT false,
                      owner boolean DEFAULT true,
                      tablespace boolean DEFAULT true)

This provides type safety at the SQL level, allows named-argument calling
syntax (pretty => true), removes the runtime string-parsing machinery
(DdlOption, parse_ddl_options) in favour of direct PG_GETARG_BOOL() calls,
and allows the functions to be marked STRICT.

While we're here, I added an extra TAP test for pg_get_database(owner =>
false, ...)

Catalog version bumped.

Author: Jelte Fennema-Nio <postgres@jeltef.nl>
Discussion: https://postgr.es/m/DHM6C7SLS4BN.1WW9Z4PRPN0VJ@jeltef.nl
(and on Discord)
doc/src/sgml/func/func-info.sgml
src/backend/utils/adt/ddlutils.c
src/include/catalog/catversion.h
src/include/catalog/pg_proc.dat
src/test/modules/test_misc/t/012_ddlutils.pl