51.11. pg_class

В каталоге pg_class описываются таблицы и прочие объекты, имеющие столбцы или каким-то образом подобные таблицам. Сюда входят индексы (но смотрите также pg_index), последовательности (но смотрите также pg_sequence), представления, материализованные представления, составные типы и таблицы TOAST; см. relkind. Далее, подразумевая все эти типы объектов, мы будем говорить об «отношениях». Не все столбцы pg_class здесь имеют смысл для всех видов отношений.

Таблица 51.11. Столбцы pg_class

Тип столбца

Описание

oidoid

Идентификатор строки

relnamename

Имя таблицы, индекса, представления и т. п.

relnamespaceoid (ссылается на pg_namespace.oid)

OID пространства имён, содержащего это отношение

reltypeoid (ссылается на pg_type.oid)

OID типа данных, соответствующего типу строки этой таблицы, если таковой есть; ноль для индексов, последовательностей и TOAST-таблиц, так как они не имеют записи в pg_type

reloftypeoid (ссылается на pg_type.oid)

OID нижележащего составного типа для типизированных таблиц; ноль для всех других отношений

relowneroid (ссылается на pg_authid.oid)

Владелец отношения

relamoid (ссылается на pg_am.oid)

Если это таблица или индекс, применяемый метод доступа (куча, B-дерево, хеш и т. д.); ноль в остальных случаях (для последовательностей, а также для нехранимых отношений, например представлений)

relfilenodeoid

Имя файла на диске с этим отношением; ноль означает, что это «отображённое» представление, имя файла для которого определяется состоянием на нижнем уровне

reltablespaceoid (ссылается на pg_tablespace.oid)

Табличное пространство, в котором хранится это отношение. Если указан ноль, подразумевается табличное пространство базы данных по умолчанию. Если у отношения нет файла на диске, указанное значение ни на что не влияет, кроме случаев с секционированными таблицами, где это табличное пространство, в котором будут создаваться секции, если пространство не указано явно в команде создания.

relpagesint4

Размер представления этой таблицы на диске (в страницах размера BLCKSZ). Это лишь примерная оценка, используемая планировщиком. Она обновляется командами VACUUM, ANALYZE и несколькими командами DDL, например CREATE INDEX.

reltuplesfloat4

Число актуальных строк в таблице. Это лишь примерная оценка, используемая планировщиком. Она обновляется командами VACUUM, ANALYZE и несколькими командами DDL, например CREATE INDEX. Если таблица ещё не подвергалась очистке или анализу, поле reltuples будет содержать -1, указывая на то, что количество строк неизвестно.

relallvisibleint4

Число страниц, помеченных как «полностью видимые» в карте видимости таблицы. Это лишь примерная оценка, используемая планировщиком. Она обновляется командами VACUUM, ANALYZE и несколькими командами DDL, например CREATE INDEX.

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

OID таблицы TOAST, связанной с данной таблицей, или ноль, если таковой нет. В таблицу TOAST, как во вторичную, «выносятся» большие атрибуты.

relhasindexbool

True, если это таблица и она имеет (или недавно имела) индексы

relissharedbool

True, если эта таблица разделяется всеми базами данных в кластере. Разделяемыми являются только некоторые системные каталоги (например pg_database).

relpersistencechar

p = постоянная таблица (permanent), u = нежурналируемая таблица (unlogged), t = временная таблица (temporary)

relkindchar

r = обычная таблица (Relation), i = индекс (Index), S = последовательность (Sequence), t = таблица TOAST, v = представление (View), m = материализованное представление (Materialized view), c = составной тип (Composite type), f = сторонняя таблица (Foreign table), p = секционированная таблица (Partitioned table), I = секционированный индекс (partitioned Index)

relnattsint2

Число пользовательских столбцов в отношении (системные столбцы не считаются). Столько же соответствующих строк должно быть в pg_attribute. См. также pg_attribute.attnum.

relchecksint2

Число ограничений CHECK в таблице; см. каталог pg_constraint

relhasrulesbool

True, если для таблицы определены (или были определены) правила; см. каталог pg_rewrite

relhastriggersbool

True, если для таблицы определены (или были определены) триггеры; см. каталог pg_trigger

relhassubclassbool

True, если у таблицы или индекса есть (или были) потомки в иерархии наследования.

relrowsecuritybool

True, если для таблицы включена защита на уровне строк; см. каталог pg_policy

relforcerowsecuritybool

True, если защита на уровне строк (когда она включена) также применяется к владельцу таблицы; см. каталог pg_policy

relispopulatedbool

True, если отношение наполнено данными (это истинно для всех отношений, кроме некоторых материализованных представлений)

relreplidentchar

Столбцы, формирующие «идентификатор реплики» для строк: d = по умолчанию (первичный ключ, если есть), n = никакие (nothing), f = все столбцы, i = индекс со свойством indisreplident (если ранее использованный индекс удалён, действует так же, как n)

relispartitionbool

True, если таблица или индекс является секцией

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

Для новых отношений, записываемых в процессе операции DDL, требующей перезаписи таблицы, это поле содержит OID исходного отношения; в противном случае — ноль. Это состояние видимо только внутри; в этом поле никогда не должно быть ненулевого значения для видимого пользователем отношения.

relfrozenxidxid

Идентификаторы транзакций, предшествующие данному, в этой таблице заменены постоянным («замороженным») идентификатором транзакции. Это нужно для определения, когда требуется очищать таблицу для предотвращения зацикливания идентификаторов или для сокращения объёма pg_xact. Если это отношение — не таблица, значение равно нулю (InvalidTransactionId).

relminmxidxid

Идентификаторы мультитранзакций, предшествующие данному, в этой таблице заменены другим идентификатором транзакции. Это нужно для определения, когда требуется очищать таблицу для предотвращения зацикливания идентификаторов мультитранзакций или для сокращения объёма pg_multixact. Если это отношение — не таблица, значение равно нулю (InvalidMultiXactId).

relaclaclitem[]

Права доступа; за подробностями обратитесь к Разделу 5.7.

reloptionstext[]

Специальные параметры для методов доступа, в виде строк «ключ=значение»

relpartboundpg_node_tree

Если таблица является секцией (см. relispartition), внутреннее представление границ секции


Некоторые логические флаги в pg_class поддерживаются не строго: гарантируется, что они будут установлены при переходе в определённое состояние, но они могут не сбрасываться немедленно, когда условия поменяются. Например, relhasindex устанавливается командой CREATE INDEX, но никогда не сбрасывается командой DROP INDEX. Вместо этого, флаг relhasindex сбрасывается командой VACUUM, если она находит, что в таблице нет индексов. Такая организация позволяет избежать состояния гонки и способствует параллельному использованию.

close