Create common infrastructure for cross-version upgrade testing.
authorTom Lane <tgl@sss.pgh.pa.us>
Tue, 17 Jan 2023 01:35:53 +0000 (20:35 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Tue, 17 Jan 2023 01:35:55 +0000 (20:35 -0500)
commit52585f8f072ac187380f7e02183e87dcf6789ff0
treeb129468957ad9c1c3cd8cb84514ae80950ea2c7f
parent980ae173108e353045e5ab4a842bb21e9dfe6715
Create common infrastructure for cross-version upgrade testing.

To test pg_upgrade across major PG versions, we have to be able to
modify or drop any old objects with no-longer-supported properties,
and we have to be able to deal with cosmetic changes in pg_dump output.
Up to now, the buildfarm and pg_upgrade's own test infrastructure had
separate implementations of the former, and we had nothing but very
ad-hoc rules for the latter (including an arbitrary threshold on how
many lines of unchecked diff were okay!).  This patch creates a Perl
module that can be shared by both those use-cases, and adds logic
that deals with pg_dump output diffs in a much more tightly defined
fashion.

This largely supersedes previous efforts in commits 0df9641d3,
9814ff550, and 62be9e4cd, which developed a SQL-script-based solution
for the task of dropping old objects.  There was nothing fundamentally
wrong with that work in itself, but it had no basis for solving the
output-formatting problem.  The most plausible way to deal with
formatting is to build a Perl module that can perform editing on the
dump files; and once we commit to that, it makes more sense for the
same module to also embed the knowledge of what has to be done for
dropping old objects.

Back-patch versions of the helper module as far as 9.2, to
support buildfarm animals that still test that far back.
It's also necessary to back-patch PostgreSQL/Version.pm,
because the new code depends on that.  I fixed up pg_upgrade's
002_pg_upgrade.pl in v15, but did not look into back-patching
it further than that.

Tom Lane and Andrew Dunstan

Discussion: https://postgr.es/m/891521.1673657296@sss.pgh.pa.us
src/bin/pg_upgrade/TESTING
src/bin/pg_upgrade/t/002_pg_upgrade.pl
src/bin/pg_upgrade/upgrade_adapt.sql [deleted file]
src/test/perl/PostgreSQL/Test/AdjustUpgrade.pm [new file with mode: 0644]