select open change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

Supported versions: Current (18) / 17 / 16 / 15 / 14
Development versions: 19 / devel
Unsupported versions: 13 / 12
Pre-release documentation. PostgreSQL 19 Beta 3 is a testing release. The final release may differ.

9.32. Statistics Information Functions #

PostgreSQL provides a function to inspect complex statistics defined using the CREATE STATISTICS command.

9.32.1. Inspecting MCV Lists #

pg_mcv_list_items ( pg_mcv_list ) → setof record

pg_mcv_list_items returns a set of records describing all items stored in a multi-column MCV list. It returns the following columns:

Name Type Description
index integer index of the item in the MCV list
values text[] values stored in the MCV item
nulls boolean[] flags identifying NULL values
frequency double precision frequency of this MCV item
base_frequency double precision base frequency of this MCV item

The pg_mcv_list_items function can be used like this:

SELECT m.* FROM pg_statistic_ext join pg_statistic_ext_data on (oid = stxoid),
                pg_mcv_list_items(stxdmcv) m WHERE stxname = 'stts';

Values of the pg_mcv_list type can be obtained only from the pg_statistic_ext_data.stxdmcv column.

Report a documentation issue

Read the upstream documentation. For corrections, first check the current version.