56.11. pg_class #
В каталоге pg_class описываются таблицы и прочие объекты, имеющие столбцы или каким-то образом подобные таблицам. Сюда входят индексы (но смотрите также pg_index), последовательности (но смотрите также pg_sequence), представления, материализованные представления, составные типы и таблицы TOAST; см. relkind. Далее, подразумевая все эти типы объектов, мы будем говорить об «отношениях». Не все столбцы pg_class здесь имеют смысл для всех видов отношений.
Таблица 56.11. Столбцы pg_class
Тип столбца Описание |
|---|
Идентификатор строки |
Имя таблицы, индекса, представления и т. п. |
OID пространства имён, содержащего это отношение |
OID типа данных, соответствующего типу строки этой таблицы, если таковой есть; ноль для индексов, последовательностей и TOAST-таблиц, так как они не имеют записи в |
OID нижележащего составного типа для типизированных таблиц; ноль для всех других отношений |
Владелец отношения |
Если это таблица или индекс, применяемый метод доступа (куча, B-дерево, хеш и т. д.); ноль в остальных случаях (для последовательностей, а также для нехранимых отношений, например представлений) |
Имя файла на диске с этим отношением; ноль означает, что это «отображённое» представление, имя файла для которого определяется состоянием на нижнем уровне |
Табличное пространство, в котором хранится это отношение. Если указан ноль, подразумевается табличное пространство базы данных по умолчанию. Если у отношения нет файла на диске, указанное значение ни на что не влияет, кроме случаев с секционированными таблицами, где это табличное пространство, в котором будут создаваться секции, если пространство не указано явно в команде создания. |
Размер представления этой таблицы на диске (в страницах размера |
Число актуальных строк в таблице. Это лишь примерная оценка, используемая планировщиком. Она обновляется командами |
Число страниц, помеченных как «полностью видимые» в карте видимости таблицы. Это лишь примерная оценка, используемая планировщиком. Она обновляется командами |
OID таблицы TOAST, связанной с данной таблицей, или ноль, если таковой нет. В таблицу TOAST, как во вторичную, «выносятся» большие атрибуты. |
True, если это таблица и она имеет (или недавно имела) индексы |
True, если эта таблица разделяется всеми базами данных в кластере. Разделяемыми являются только некоторые системные каталоги (например |
|
|
Число пользовательских столбцов в отношении (системные столбцы не считаются). Столько же соответствующих строк должно быть в |
Число ограничений |
True, если для таблицы определены (или были определены) правила; см. каталог |
True, если для таблицы определены (или были определены) триггеры; см. каталог |
True, если у таблицы или индекса есть (или были) секции или потомки в иерархии наследования |
True, если для таблицы включена защита на уровне строк; см. каталог |
True, если защита на уровне строк (когда она включена) также применяется к владельцу таблицы; см. каталог |
True, если отношение наполнено данными (это истинно для всех отношений, кроме некоторых материализованных представлений) |
Столбцы, формирующие «идентификатор реплики» для строк: |
True, если таблица или индекс является секцией |
Для новых отношений, записываемых в процессе операции DDL, требующей перезаписи таблицы, это поле содержит OID исходного отношения; в противном случае — ноль. Это состояние видимо только внутри; в этом поле никогда не должно быть ненулевого значения для видимого пользователем отношения. |
Идентификаторы транзакций, предшествующие данному, в этой таблице заменены постоянным («замороженным») идентификатором транзакции. Это нужно для определения, когда требуется очищать таблицу для сокращения объёма |
Идентификаторы мультитранзакций, предшествующие данному, в этой таблице заменены другим идентификатором транзакции. Это нужно для определения, когда требуется очищать таблицу для сокращения объёма |
Права доступа; за подробностями обратитесь к Разделу 5.7. |
Специальные параметры для методов доступа, в виде строк «ключ=значение» |
Если таблица является секцией (см. |
Некоторые логические флаги в pg_class поддерживаются не строго: гарантируется, что они будут установлены при переходе в определённое состояние, но они могут не сбрасываться немедленно, когда условия поменяются. Например, relhasindex устанавливается командой CREATE INDEX, но никогда не сбрасывается командой DROP INDEX. Вместо этого, флаг relhasindex сбрасывается командой VACUUM, если она находит, что в таблице нет индексов. Такая организация позволяет избежать состояния гонки и способствует параллельному использованию.
56.11. pg_class #
The catalog pg_class describes tables and other objects that have columns or are otherwise similar to a table. This includes indexes (but see also pg_index), sequences (but see also pg_sequence), views, materialized views, composite types, and TOAST tables; see relkind. Below, when we mean all of these kinds of objects we speak of “relations”. Not all of pg_class's columns are meaningful for all relation kinds.
Table 56.11. pg_class Columns
Column Type Description |
|---|
Row identifier |
Name of the table, index, view, etc. |
The OID of the namespace that contains this relation |
The OID of the data type that corresponds to this table's row type, if any; zero for indexes, sequences, and toast tables, which have no |
For typed tables, the OID of the underlying composite type; zero for all other relations |
Owner of the relation |
If this is a table or an index, the access method used (heap, B-tree, hash, etc.); otherwise zero (zero occurs for sequences, as well as relations without storage, such as views) |
Name of the on-disk file of this relation; zero means this is a “mapped” relation whose disk file name is determined by low-level state |
The tablespace in which this relation is stored. If zero, the database's default tablespace is implied. Not meaningful if the relation has no on-disk file, except for partitioned tables, where this is the tablespace in which partitions will be created when one is not specified in the creation command. |
Size of the on-disk representation of this table in pages (of size |
Number of live rows in the table. This is only an estimate used by the planner. It is updated by |
Number of pages that are marked all-visible in the table's visibility map. This is only an estimate used by the planner. It is updated by |
OID of the TOAST table associated with this table, zero if none. The TOAST table stores large attributes “out of line” in a secondary table. |
True if this is a table and it has (or recently had) any indexes |
True if this table is shared across all databases in the cluster. Only certain system catalogs (such as |
|
|
Number of user columns in the relation (system columns not counted). There must be this many corresponding entries in |
Number of |
True if table has (or once had) rules; see |
True if table has (or once had) triggers; see |
True if table or index has (or once had) any inheritance children or partitions |
True if table has row-level security enabled; see |
True if row-level security (when enabled) will also apply to table owner; see |
True if relation is populated (this is true for all relations other than some materialized views) |
Columns used to form “replica identity” for rows: |
True if table or index is a partition |
For new relations being written during a DDL operation that requires a table rewrite, this contains the OID of the original relation; otherwise zero. That state is only visible internally; this field should never contain anything other than zero for a user-visible relation. |
All transaction IDs before this one have been replaced with a permanent (“frozen”) transaction ID in this table. This is used to track whether the table needs to be vacuumed in order to allow |
All multixact IDs before this one have been replaced by a transaction ID in this table. This is used to track whether the table needs to be vacuumed in order to allow |
Access privileges; see Section 5.7 for details |
Access-method-specific options, as “keyword=value” strings |
If table is a partition (see |
Several of the Boolean flags in pg_class are maintained lazily: they are guaranteed to be true if that's the correct state, but may not be reset to false immediately when the condition is no longer true. For example, relhasindex is set by CREATE INDEX, but it is never cleared by DROP INDEX. Instead, VACUUM clears relhasindex if it finds the table has no indexes. This arrangement avoids race conditions and improves concurrency.
