Add PROCESS_MAIN to VACUUM
Michael Paquier <michael@paquier.xyz>
Add PROCESS_MAIN to VACUUM Disabling this option is useful to run VACUUM (with or without FULL) on only the toast table of a relation, bypassing the main relation. This option is enabled by default. Running directly VACUUM on a toast table was already possible without this feature, by using the non-deterministic name of a toast relation (as of pg_toast.pg_toast_N, where N would be the OID of the parent relation) in the VACUUM command, and it required a scan of pg_class to know the name of the toast table. So this feature is basically a shortcut to be able to run VACUUM or VACUUM FULL on a toast relation, using only the name of the parent relation. A new switch called --no-process-main is added to vacuumdb, to work as an equivalent of PROCESS_MAIN. Regression tests are added to cover VACUUM and VACUUM FULL, looking at pg_stat_all_tables.vacuum_count to see how many vacuums have run on each table, main or toast. Author: Nathan Bossart Reviewed-by: Masahiko Sawada Discussion: https://postgr.es/m/20221230000028.GA435655@nathanxps13
Files
| Path | Change | +/− |
|---|---|---|
| doc/src/sgml/ref/vacuumdb.sgml | modified | +15 −0 |
| doc/src/sgml/ref/vacuum.sgml | modified | +13 −0 |
| src/backend/commands/vacuum.c | modified | +22 −6 |
| src/backend/postmaster/autovacuum.c | modified | +3 −1 |
| src/bin/psql/tab-complete.c | modified | +2 −2 |
| src/bin/scripts/t/100_vacuumdb.pl | modified | +7 −0 |
| src/bin/scripts/vacuumdb.c | modified | +24 −0 |
| src/include/commands/vacuum.h | modified | +5 −4 |
| src/test/regress/expected/vacuum.out | modified | +43 −1 |
| src/test/regress/sql/vacuum.sql | modified | +22 −1 |
Documentation touched
Discussion
- add PROCESS_MAIN to VACUUM 34 messages · 2022-12-30 → 2023-03-08