Fix EXPLAIN (SETTINGS) to follow policy about when to print empty fields.
authorTom Lane <tgl@sss.pgh.pa.us>
Sun, 26 Jan 2020 21:31:48 +0000 (16:31 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Sun, 26 Jan 2020 21:32:19 +0000 (16:32 -0500)
commit3ec20c7091e97a554e7447ac2b7f4ed795631395
treed5d4ad63f0df5f51f4e39511a2971ebe34b3df12
parentf37ff03478aefb5e01d748b85ad86e6213624992
Fix EXPLAIN (SETTINGS) to follow policy about when to print empty fields.

In non-TEXT output formats, the "Settings" field should appear when
requested, even if it would be empty.

Also, get rid of the premature optimization of counting all the
GUC_EXPLAIN variables at startup.  Since there was no provision for
adjusting that count later, all it'd take would be some extension marking
a parameter as GUC_EXPLAIN to risk an assertion failure or memory stomp.
We could make get_explain_guc_options() count those variables on-the-fly,
or dynamically resize its array ... but TBH I do not think that making a
transient array of pointers a bit smaller is worth any extra complication,
especially when you consider all the other transient space EXPLAIN eats.
So just allocate that array at the max possible size.

In HEAD, also add some regression test coverage for this feature.

Because of the memory-stomp hazard, back-patch to v12 where this
feature was added.

Discussion: https://postgr.es/m/19416.1580069629@sss.pgh.pa.us
src/backend/commands/explain.c
src/backend/utils/misc/guc.c
src/test/regress/expected/explain.out
src/test/regress/sql/explain.sql