mirror of
https://github.com/postgres/postgres.git
synced 2026-03-04 06:10:57 -05:00
vacuum_truncate controls whether vacuum tries to truncate off any empty pages at the end of the table. Previously vacuum always tried to do the truncation. However, the truncation could cause some problems; for example, ACCESS EXCLUSIVE lock needs to be taken on the table during the truncation and can cause the query cancellation on the standby even if hot_standby_feedback is true. Setting this reloption to false can be helpful to avoid such problems. Author: Tsunakawa Takayuki Reviewed-By: Julien Rouhaud, Masahiko Sawada, Michael Paquier, Kirk Jamison and Fujii Masao Discussion: https://postgr.es/m/CAHGQGwE5UqFqSq1=kV3QtTUtXphTdyHA-8rAj4A=Y+e4kyp3BQ@mail.gmail.com
130 lines
5.2 KiB
SQL
130 lines
5.2 KiB
SQL
|
|
-- Simple create
|
|
CREATE TABLE reloptions_test(i INT) WITH (FiLLFaCToR=30,
|
|
autovacuum_enabled = false, autovacuum_analyze_scale_factor = 0.2);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
|
|
-- Fail min/max values check
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor=2);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor=110);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_analyze_scale_factor = -10.0);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_analyze_scale_factor = 110.0);
|
|
|
|
-- Fail when option and namespace do not exist
|
|
CREATE TABLE reloptions_test2(i INT) WITH (not_existing_option=2);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (not_existing_namespace.fillfactor=2);
|
|
|
|
-- Fail while setting improper values
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor=-30.1);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor='string');
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor=true);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_enabled=12);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_enabled=30.5);
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_enabled='string');
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_analyze_scale_factor='string');
|
|
CREATE TABLE reloptions_test2(i INT) WITH (autovacuum_analyze_scale_factor=true);
|
|
|
|
-- Fail if option is specified twice
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor=30, fillfactor=40);
|
|
|
|
-- Specifying name only for a non-Boolean option should fail
|
|
CREATE TABLE reloptions_test2(i INT) WITH (fillfactor);
|
|
|
|
-- Simple ALTER TABLE
|
|
ALTER TABLE reloptions_test SET (fillfactor=31,
|
|
autovacuum_analyze_scale_factor = 0.3);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
|
|
-- Set boolean option to true without specifying value
|
|
ALTER TABLE reloptions_test SET (autovacuum_enabled, fillfactor=32);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
|
|
-- Check that RESET works well
|
|
ALTER TABLE reloptions_test RESET (fillfactor);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
|
|
-- Resetting all values causes the column to become null
|
|
ALTER TABLE reloptions_test RESET (autovacuum_enabled,
|
|
autovacuum_analyze_scale_factor);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass AND
|
|
reloptions IS NULL;
|
|
|
|
-- RESET fails if a value is specified
|
|
ALTER TABLE reloptions_test RESET (fillfactor=12);
|
|
|
|
-- Test vacuum_truncate option
|
|
DROP TABLE reloptions_test;
|
|
|
|
CREATE TABLE reloptions_test(i INT NOT NULL, j text)
|
|
WITH (vacuum_truncate=false,
|
|
toast.vacuum_truncate=false,
|
|
autovacuum_enabled=false);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
INSERT INTO reloptions_test VALUES (1, NULL), (NULL, NULL);
|
|
VACUUM reloptions_test;
|
|
SELECT pg_relation_size('reloptions_test') > 0;
|
|
|
|
SELECT reloptions FROM pg_class WHERE oid =
|
|
(SELECT reltoastrelid FROM pg_class
|
|
WHERE oid = 'reloptions_test'::regclass);
|
|
|
|
ALTER TABLE reloptions_test RESET (vacuum_truncate);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
INSERT INTO reloptions_test VALUES (1, NULL), (NULL, NULL);
|
|
VACUUM reloptions_test;
|
|
SELECT pg_relation_size('reloptions_test') = 0;
|
|
|
|
-- Test toast.* options
|
|
DROP TABLE reloptions_test;
|
|
|
|
CREATE TABLE reloptions_test (s VARCHAR)
|
|
WITH (toast.autovacuum_vacuum_cost_delay = 23);
|
|
SELECT reltoastrelid as toast_oid
|
|
FROM pg_class WHERE oid = 'reloptions_test'::regclass \gset
|
|
SELECT reloptions FROM pg_class WHERE oid = :toast_oid;
|
|
|
|
ALTER TABLE reloptions_test SET (toast.autovacuum_vacuum_cost_delay = 24);
|
|
SELECT reloptions FROM pg_class WHERE oid = :toast_oid;
|
|
|
|
ALTER TABLE reloptions_test RESET (toast.autovacuum_vacuum_cost_delay);
|
|
SELECT reloptions FROM pg_class WHERE oid = :toast_oid;
|
|
|
|
-- Fail on non-existent options in toast namespace
|
|
CREATE TABLE reloptions_test2 (i int) WITH (toast.not_existing_option = 42);
|
|
|
|
-- Mix TOAST & heap
|
|
DROP TABLE reloptions_test;
|
|
|
|
CREATE TABLE reloptions_test (s VARCHAR) WITH
|
|
(toast.autovacuum_vacuum_cost_delay = 23,
|
|
autovacuum_vacuum_cost_delay = 24, fillfactor = 40);
|
|
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test'::regclass;
|
|
SELECT reloptions FROM pg_class WHERE oid = (
|
|
SELECT reltoastrelid FROM pg_class WHERE oid = 'reloptions_test'::regclass);
|
|
|
|
--
|
|
-- CREATE INDEX, ALTER INDEX for btrees
|
|
--
|
|
|
|
CREATE INDEX reloptions_test_idx ON reloptions_test (s) WITH (fillfactor=30);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test_idx'::regclass;
|
|
|
|
-- Fail when option and namespace do not exist
|
|
CREATE INDEX reloptions_test_idx ON reloptions_test (s)
|
|
WITH (not_existing_option=2);
|
|
CREATE INDEX reloptions_test_idx ON reloptions_test (s)
|
|
WITH (not_existing_ns.fillfactor=2);
|
|
|
|
-- Check allowed ranges
|
|
CREATE INDEX reloptions_test_idx2 ON reloptions_test (s) WITH (fillfactor=1);
|
|
CREATE INDEX reloptions_test_idx2 ON reloptions_test (s) WITH (fillfactor=130);
|
|
|
|
-- Check ALTER
|
|
ALTER INDEX reloptions_test_idx SET (fillfactor=40);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test_idx'::regclass;
|
|
|
|
-- Check ALTER on empty reloption list
|
|
CREATE INDEX reloptions_test_idx3 ON reloptions_test (s);
|
|
ALTER INDEX reloptions_test_idx3 SET (fillfactor=40);
|
|
SELECT reloptions FROM pg_class WHERE oid = 'reloptions_test_idx3'::regclass;
|