2011-08-25 06:06:16 +02:00
|
|
|
CREATE EXTENSION pgstattuple;
|
|
|
|
|
|
|
|
--
|
|
|
|
-- It's difficult to come up with platform-independent test cases for
|
|
|
|
-- the pgstattuple functions, but the results for empty tables and
|
|
|
|
-- indexes should be that.
|
|
|
|
--
|
|
|
|
|
2012-12-05 08:58:03 +01:00
|
|
|
create table test (a int primary key, b int[]);
|
2011-08-25 06:06:16 +02:00
|
|
|
|
2013-07-18 20:50:20 +02:00
|
|
|
select * from pgstattuple('test');
|
2011-08-25 06:06:16 +02:00
|
|
|
select * from pgstattuple('test'::text);
|
2013-07-18 20:50:20 +02:00
|
|
|
select * from pgstattuple('test'::name);
|
2011-08-25 06:06:16 +02:00
|
|
|
select * from pgstattuple('test'::regclass);
|
2013-07-18 20:50:20 +02:00
|
|
|
select pgstattuple(oid) from pg_class where relname = 'test';
|
|
|
|
select pgstattuple(relname) from pg_class where relname = 'test';
|
2011-08-25 06:06:16 +02:00
|
|
|
|
Fix multiple bugs in contrib/pgstattuple's pgstatindex() function.
Dead or half-dead index leaf pages were incorrectly reported as live, as a
consequence of a code rearrangement I made (during a moment of severe brain
fade, evidently) in commit d287818eb514d431.
The index metapage was not counted in index_size, causing that result to
not agree with the actual index size on-disk.
Index root pages were not counted in internal_pages, which is inconsistent
compared to the case of a root that's also a leaf (one-page index), where
the root would be counted in leaf_pages. Aside from that inconsistency,
this could lead to additional transient discrepancies between the reported
page counts and index_size, since it's possible for pgstatindex's scan to
see zero or multiple pages marked as BTP_ROOT, if the root moves due to
a split during the scan. With these fixes, index_size will always be
exactly one page more than the sum of the displayed page counts.
Also, the index_size result was incorrectly documented as being measured in
pages; it's always been measured in bytes. (While fixing that, I couldn't
resist doing some small additional wordsmithing on the pgstattuple docs.)
Including the metapage causes the reported index_size to not be zero for
an empty index. To preserve the desired property that the pgstattuple
regression test results are platform-independent (ie, BLCKSZ configuration
independent), scale the index_size result in the regression tests.
The documentation issue was reported by Otsuka Kenji, and the inconsistent
root page counting by Peter Geoghegan; the other problems noted by me.
Back-patch to all supported branches, because this has been broken for
a long time.
2016-02-18 21:40:35 +01:00
|
|
|
select version, tree_level,
|
|
|
|
index_size / current_setting('block_size')::int as index_size,
|
|
|
|
root_block_no, internal_pages, leaf_pages, empty_pages, deleted_pages,
|
|
|
|
avg_leaf_density, leaf_fragmentation
|
|
|
|
from pgstatindex('test_pkey');
|
|
|
|
select version, tree_level,
|
|
|
|
index_size / current_setting('block_size')::int as index_size,
|
|
|
|
root_block_no, internal_pages, leaf_pages, empty_pages, deleted_pages,
|
|
|
|
avg_leaf_density, leaf_fragmentation
|
|
|
|
from pgstatindex('test_pkey'::text);
|
|
|
|
select version, tree_level,
|
|
|
|
index_size / current_setting('block_size')::int as index_size,
|
|
|
|
root_block_no, internal_pages, leaf_pages, empty_pages, deleted_pages,
|
|
|
|
avg_leaf_density, leaf_fragmentation
|
|
|
|
from pgstatindex('test_pkey'::name);
|
|
|
|
select version, tree_level,
|
|
|
|
index_size / current_setting('block_size')::int as index_size,
|
|
|
|
root_block_no, internal_pages, leaf_pages, empty_pages, deleted_pages,
|
|
|
|
avg_leaf_density, leaf_fragmentation
|
|
|
|
from pgstatindex('test_pkey'::regclass);
|
2011-08-25 06:06:16 +02:00
|
|
|
|
|
|
|
select pg_relpages('test');
|
|
|
|
select pg_relpages('test_pkey');
|
2013-07-18 20:50:20 +02:00
|
|
|
select pg_relpages('test_pkey'::text);
|
|
|
|
select pg_relpages('test_pkey'::name);
|
|
|
|
select pg_relpages('test_pkey'::regclass);
|
|
|
|
select pg_relpages(oid) from pg_class where relname = 'test_pkey';
|
|
|
|
select pg_relpages(relname) from pg_class where relname = 'test_pkey';
|
2012-12-05 08:58:03 +01:00
|
|
|
|
|
|
|
create index test_ginidx on test using gin (b);
|
|
|
|
|
|
|
|
select * from pgstatginindex('test_ginidx');
|
2017-02-03 20:35:25 +01:00
|
|
|
|
|
|
|
create index test_hashidx on test using hash (b);
|
|
|
|
|
|
|
|
select * from pgstathashindex('test_hashidx');
|
2017-03-09 22:34:25 +01:00
|
|
|
|
|
|
|
-- these should error with the wrong type
|
|
|
|
select pgstatginindex('test_pkey');
|
|
|
|
select pgstathashindex('test_pkey');
|
|
|
|
|
|
|
|
select pgstatindex('test_ginidx');
|
|
|
|
select pgstathashindex('test_ginidx');
|
|
|
|
|
|
|
|
select pgstatindex('test_hashidx');
|
|
|
|
select pgstatginindex('test_hashidx');
|
|
|
|
|
|
|
|
-- check that using any of these functions with unsupported relations will fail
|
|
|
|
create table test_partitioned (a int) partition by range (a);
|
2018-05-09 19:03:43 +02:00
|
|
|
create index test_partitioned_index on test_partitioned(a);
|
2023-12-19 07:20:50 +01:00
|
|
|
create index test_partitioned_hash_index on test_partitioned using hash(a);
|
2017-03-09 22:34:25 +01:00
|
|
|
-- these should all fail
|
|
|
|
select pgstattuple('test_partitioned');
|
2018-05-09 19:03:43 +02:00
|
|
|
select pgstattuple('test_partitioned_index');
|
2017-03-09 22:34:25 +01:00
|
|
|
select pgstattuple_approx('test_partitioned');
|
|
|
|
select pg_relpages('test_partitioned');
|
|
|
|
select pgstatindex('test_partitioned');
|
|
|
|
select pgstatginindex('test_partitioned');
|
|
|
|
select pgstathashindex('test_partitioned');
|
2023-12-19 07:20:50 +01:00
|
|
|
select pgstathashindex('test_partitioned_hash_index');
|
2017-03-09 22:34:25 +01:00
|
|
|
|
|
|
|
create view test_view as select 1;
|
|
|
|
-- these should all fail
|
|
|
|
select pgstattuple('test_view');
|
|
|
|
select pgstattuple_approx('test_view');
|
|
|
|
select pg_relpages('test_view');
|
|
|
|
select pgstatindex('test_view');
|
|
|
|
select pgstatginindex('test_view');
|
|
|
|
select pgstathashindex('test_view');
|
|
|
|
|
|
|
|
create foreign data wrapper dummy;
|
|
|
|
create server dummy_server foreign data wrapper dummy;
|
|
|
|
create foreign table test_foreign_table () server dummy_server;
|
|
|
|
-- these should all fail
|
|
|
|
select pgstattuple('test_foreign_table');
|
|
|
|
select pgstattuple_approx('test_foreign_table');
|
|
|
|
select pg_relpages('test_foreign_table');
|
|
|
|
select pgstatindex('test_foreign_table');
|
|
|
|
select pgstatginindex('test_foreign_table');
|
|
|
|
select pgstathashindex('test_foreign_table');
|
|
|
|
|
|
|
|
-- a partition of a partitioned table should work though
|
|
|
|
create table test_partition partition of test_partitioned for values from (1) to (100);
|
|
|
|
select pgstattuple('test_partition');
|
|
|
|
select pgstattuple_approx('test_partition');
|
|
|
|
select pg_relpages('test_partition');
|
|
|
|
|
2020-06-30 00:29:35 +02:00
|
|
|
-- toast tables should work
|
|
|
|
select pgstattuple((select reltoastrelid from pg_class where relname = 'test'));
|
|
|
|
select pgstattuple_approx((select reltoastrelid from pg_class where relname = 'test'));
|
|
|
|
select pg_relpages((select reltoastrelid from pg_class where relname = 'test'));
|
|
|
|
|
2017-03-09 22:34:25 +01:00
|
|
|
-- not for the index calls though, of course
|
|
|
|
select pgstatindex('test_partition');
|
|
|
|
select pgstatginindex('test_partition');
|
|
|
|
select pgstathashindex('test_partition');
|
|
|
|
|
2017-03-10 02:06:11 +01:00
|
|
|
-- an actual index of a partitioned table should work though
|
2017-03-09 22:34:25 +01:00
|
|
|
create index test_partition_idx on test_partition(a);
|
|
|
|
create index test_partition_hash_idx on test_partition using hash (a);
|
|
|
|
-- these should work
|
|
|
|
select pgstatindex('test_partition_idx');
|
|
|
|
select pgstathashindex('test_partition_hash_idx');
|
|
|
|
|
|
|
|
drop table test_partitioned;
|
|
|
|
drop view test_view;
|
|
|
|
drop foreign table test_foreign_table;
|
|
|
|
drop server dummy_server;
|
|
|
|
drop foreign data wrapper dummy;
|