ДОКУМЕНТАЦИЯ

Выберите версию, форк и язык для СУБД Digital Q.DataBase, чтобы прочитать или скачать всю документацию.

Новости

01.09.2026

СУБД Digital Q.DataBase можно развернуть из готового Docker-образа

25.08.2026

СУБД Digital Q.DataBase: 8 ядер бесплатно — до 1 сентября!

Документация

Диасофт
Авторские права © 2016–2025 ООО "Диасофт Экосистема"

Скачать всю документацию:

pdf (13 mБ) EPUB (13 mБ) CHM (14 МБ)

7.2.51. pg_statistic

Содержание

Системный каталог pg_statistic хранит статистические данные о содержимом базы данных. Записи создаются с помощью команды ANALYZE и впоследствии используются планировщиком запросов. Обратите внимание, что все статистические данные по своей сути являются приблизительными, даже при условии их актуальности.

Обычно для каждого проанализированного столбца таблицы создается одна запись с параметром stainherit = false. Если у таблицы имеются дочерние таблицы или секции, также создается вторая запись с stainherit = true is also created. Эта строка представляет статистику столбца по всему дереву наследования, то есть статистику данных, которые были бы получены при выполнении запроса SELECT column FROM table*, тогда как строка с параметром stainherit = false отражает результаты выполнения команды SELECT column FROM ONLY table.

pg_statistic также хранит статистические данные о значениях выражений в индексах. Они описываются так, как если бы они были фактическими столбцами данных; в частности, starelid ссылается на индекс. Тем не менее, записи для обычного (не являющегося выражением) столбца индекса не создаются, так как они были бы избыточны по отношению к записям для соответствующего столбца таблицы. В настоящее время записи для индексных выражений всегда имеют stainherit = false.

Поскольку для различных типов данных могут подходить разные виды статистических данных, pg_statistic спроектирован так, чтобы не накладывать строгих ограничений на тип хранимой статистики. В системном каталоге выделены отдельные столбцы только для наиболее общих статистических данных (таких как наличие значений NULL) в pg_statistic. Вся остальная информация хранится в «слотах», которые представляют собой группы связанных столбцов, содержимое которых идентифицируется кодовым числом в одном из столбцов слота. Для получения дополнительной информации см. src/include/catalog/pg_statistic.h.

pg_statistic не должен быть доступен для общего чтения, так как даже статистическая информация о содержимом таблицы может считаться конфиденциальной. (Пример: минимальное и максимальное значения в столбце зарплаты могут представлять определенный интерес.) pg_stats является общедоступным представлением для pg_statistic который предоставляет информацию только о тех таблицах, которые доступны для чтения текущему пользователю.

Таблица 7.2.51. pg_statistic Столбцы

Тип столбца Описание
`starelid` `oid` (ссылается на `pg_class`.`oid`) Таблица или индекс, к которым относится описываемый столбец
`staattnum` `int2` (ссылается на `pg_attribute`.`attnum`) Номер описываемого столбца
`stainherit` `bool` Если значение истинно (true), статистика включает данные из дочерних таблиц, а не только значения из указанного отношения
`stanullfrac` `float4` Доля записей в столбце, содержащих значения NULL
`stawidth` `int4` Средняя ширина (в байтах) записей, отличных от NULL
`stadistinct` `float4` Количество уникальных значений в столбце, отличных от NULL. Значение больше нуля является фактическим количеством уникальных значений. Значение меньше нуля представляет собой взятый с отрицательным знаком множитель для общего числа строк в таблице; например, столбец, в котором около 80% значений не являются NULL и каждое такое значение встречается в среднем дважды, может быть описан значением `stadistinct` = -0.4. Нулевое значение означает, что количество уникальных значений неизвестно.
`stakindN` `int2` Код, указывающий тип статистики, хранящейся в `N`-м «слоте» данной `pg_statistic` строки.
`staopN` `oid` (ссылается на `pg_operator`.`oid`) Оператор, используемый для получения статистических данных, хранящихся в `N`-м «слоте». Например, для слота гистограммы будет указан `<` оператор , определяющий порядок сортировки данных. Ноль, если для данного типа статистики оператор не требуется.
`stacollN` `oid` (ссылается на `pg_collation`.`oid`) Правило сортировки, используемое для получения статистических данных, хранящихся в `N`-м «слоте». Например, для слоте гистограммы для столбца, поддерживающего правила сортировки, будет указано правило сортировки, которое определяет порядок сортировки данных. Ноль для данных, не поддерживающих правила сортировки (коллации).
`stanumbersN` `float4[]` Числовая статистика соответствующего вида для `N`-м «слоте», или null, если слот данного вида не содержит числовых значений
`stavaluesN` `anyarray` Значения данных столбца соответствующего вида для `N`-м «слоте», или null, если слот данного вида не хранит никаких значений данных. Значения элементов каждого массива фактически относятся к типу данных конкретного столбца или к связанному типу, такому как тип элемента массива, поэтому невозможно определить тип этих столбцов более точно, чем `anyarray`.

Тип столбца

Описание

starelid oid (ссылается на pg_class.oid)

Таблица или индекс, к которым относится описываемый столбец

staattnum int2 (ссылается на pg_attribute.attnum)

Номер описываемого столбца

stainherit bool

Если значение истинно (true), статистика включает данные из дочерних таблиц, а не только значения из указанного отношения

stanullfrac float4

Доля записей в столбце, содержащих значения NULL

stawidth int4

Средняя ширина (в байтах) записей, отличных от NULL

stadistinct float4

Количество уникальных значений в столбце, отличных от NULL. Значение больше нуля является фактическим количеством уникальных значений. Значение меньше нуля представляет собой взятый с отрицательным знаком множитель для общего числа строк в таблице; например, столбец, в котором около 80% значений не являются NULL и каждое такое значение встречается в среднем дважды, может быть описан значением stadistinct = -0.4. Нулевое значение означает, что количество уникальных значений неизвестно.

stakindN int2

Код, указывающий тип статистики, хранящейся в N-м «слоте» данной pg_statistic строки.

staopN oid (ссылается на pg_operator.oid)

Оператор, используемый для получения статистических данных, хранящихся в N-м «слоте». Например, для слота гистограммы будет указан < оператор , определяющий порядок сортировки данных. Ноль, если для данного типа статистики оператор не требуется.

stacollN oid (ссылается на pg_collation.oid)

Правило сортировки, используемое для получения статистических данных, хранящихся в N-м «слоте». Например, для слоте гистограммы для столбца, поддерживающего правила сортировки, будет указано правило сортировки, которое определяет порядок сортировки данных. Ноль для данных, не поддерживающих правила сортировки (коллации).

stanumbersN float4[]

Числовая статистика соответствующего вида для N-м «слоте», или null, если слот данного вида не содержит числовых значений

stavaluesN anyarray

Значения данных столбца соответствующего вида для N-м «слоте», или null, если слот данного вида не хранит никаких значений данных. Значения элементов каждого массива фактически относятся к типу данных конкретного столбца или к связанному типу, такому как тип элемента массива, поэтому невозможно определить тип этих столбцов более точно, чем anyarray.

Наверх