mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-10-02 18:11:18 +02:00
ed0097e4f9
Per discussion, we should provide such functions to replace the lost ability to discover AM properties by inspecting pg_am (cf commit65c5fcd35). The added functionality is also meant to displace any code that was looking directly at pg_index.indoption, since we'd rather not believe that the bit meanings in that field are part of any client API contract. As future-proofing, define the SQL API to not assume that properties that are currently AM-wide or index-wide will remain so unless they logically must be; instead, expose them only when inquiring about a specific index or even specific index column. Also provide the ability for an index AM to override the behavior. In passing, document pg_am.amtype, overlooked in commit473b93287. Andrew Gierth, with kibitzing by me and others Discussion: <87mvl5on7n.fsf@news-spur.riddles.org.uk>
88 lines
3.6 KiB
SQL
88 lines
3.6 KiB
SQL
--
|
|
-- Test index AM property-reporting functions
|
|
--
|
|
|
|
select prop,
|
|
pg_indexam_has_property(a.oid, prop) as "AM",
|
|
pg_index_has_property('onek_hundred'::regclass, prop) as "Index",
|
|
pg_index_column_has_property('onek_hundred'::regclass, 1, prop) as "Column"
|
|
from pg_am a,
|
|
unnest(array['asc', 'desc', 'nulls_first', 'nulls_last',
|
|
'orderable', 'distance_orderable', 'returnable',
|
|
'search_array', 'search_nulls',
|
|
'clusterable', 'index_scan', 'bitmap_scan',
|
|
'backward_scan',
|
|
'can_order', 'can_unique', 'can_multi_col',
|
|
'can_exclude',
|
|
'bogus']::text[])
|
|
with ordinality as u(prop,ord)
|
|
where a.amname = 'btree'
|
|
order by ord;
|
|
|
|
select prop,
|
|
pg_indexam_has_property(a.oid, prop) as "AM",
|
|
pg_index_has_property('gcircleind'::regclass, prop) as "Index",
|
|
pg_index_column_has_property('gcircleind'::regclass, 1, prop) as "Column"
|
|
from pg_am a,
|
|
unnest(array['asc', 'desc', 'nulls_first', 'nulls_last',
|
|
'orderable', 'distance_orderable', 'returnable',
|
|
'search_array', 'search_nulls',
|
|
'clusterable', 'index_scan', 'bitmap_scan',
|
|
'backward_scan',
|
|
'can_order', 'can_unique', 'can_multi_col',
|
|
'can_exclude',
|
|
'bogus']::text[])
|
|
with ordinality as u(prop,ord)
|
|
where a.amname = 'gist'
|
|
order by ord;
|
|
|
|
select prop,
|
|
pg_index_column_has_property('onek_hundred'::regclass, 1, prop) as btree,
|
|
pg_index_column_has_property('hash_i4_index'::regclass, 1, prop) as hash,
|
|
pg_index_column_has_property('gcircleind'::regclass, 1, prop) as gist,
|
|
pg_index_column_has_property('sp_radix_ind'::regclass, 1, prop) as spgist,
|
|
pg_index_column_has_property('botharrayidx'::regclass, 1, prop) as gin,
|
|
pg_index_column_has_property('brinidx'::regclass, 1, prop) as brin
|
|
from unnest(array['asc', 'desc', 'nulls_first', 'nulls_last',
|
|
'orderable', 'distance_orderable', 'returnable',
|
|
'search_array', 'search_nulls',
|
|
'bogus']::text[])
|
|
with ordinality as u(prop,ord)
|
|
order by ord;
|
|
|
|
select prop,
|
|
pg_index_has_property('onek_hundred'::regclass, prop) as btree,
|
|
pg_index_has_property('hash_i4_index'::regclass, prop) as hash,
|
|
pg_index_has_property('gcircleind'::regclass, prop) as gist,
|
|
pg_index_has_property('sp_radix_ind'::regclass, prop) as spgist,
|
|
pg_index_has_property('botharrayidx'::regclass, prop) as gin,
|
|
pg_index_has_property('brinidx'::regclass, prop) as brin
|
|
from unnest(array['clusterable', 'index_scan', 'bitmap_scan',
|
|
'backward_scan',
|
|
'bogus']::text[])
|
|
with ordinality as u(prop,ord)
|
|
order by ord;
|
|
|
|
select amname, prop, pg_indexam_has_property(a.oid, prop) as p
|
|
from pg_am a,
|
|
unnest(array['can_order', 'can_unique', 'can_multi_col',
|
|
'can_exclude', 'bogus']::text[])
|
|
with ordinality as u(prop,ord)
|
|
where amtype = 'i'
|
|
order by amname, ord;
|
|
|
|
--
|
|
-- additional checks for pg_index_column_has_property
|
|
--
|
|
CREATE TEMP TABLE foo (f1 int, f2 int, f3 int, f4 int);
|
|
|
|
CREATE INDEX fooindex ON foo (f1 desc, f2 asc, f3 nulls first, f4 nulls last);
|
|
|
|
select col, prop, pg_index_column_has_property(o, col, prop)
|
|
from (values ('fooindex'::regclass)) v1(o),
|
|
(values (1,'orderable'),(2,'asc'),(3,'desc'),
|
|
(4,'nulls_first'),(5,'nulls_last'),
|
|
(6, 'bogus')) v2(idx,prop),
|
|
generate_series(1,4) col
|
|
order by col, idx;
|