| Документация по PostgreSQL 9.4.1 | |||
|---|---|---|---|
| Пред. | Уровень выше | Глава 48. Системные каталоги | След. |
48.11. pg_class
В каталоге pg_class описываются таблицы и практически всё, что имеет колонки или каким-то образом подобно таблице. Сюда входят индексы (но смотрите также pg_index), последовательности, представления, материализованные представления, составные типы и таблицы TOAST; см. relkind. Далее, подразумевая все эти типы объектов, мы будем говорить об "отношениях". Не все колонки здесь имеют смысл для всех типов отношений.
Таблица 48-11. Колонки pg_class
| Имя | Тип | Ссылки | Описание |
|---|---|---|---|
| oid | oid | Идентификатор строки (скрытый атрибут; должен выбираться явно) | |
| relname | name | Имя таблицы, индекса, представления и т. п. | |
| relnamespace | oid | pg_namespace.oid | OID пространства имён, содержащего это отношение |
| reltype | oid | pg_type.oid | OID типа данных, соответствующего типу строки этой таблицы, если таковой есть (ноль для индексов, так как они не имеют записи в pg_type) |
| reloftype | oid | pg_type.oid | Для типизированных таблиц, OID нижележащего составного типа, или ноль для всех других отношений |
| relowner | oid | pg_authid.oid | Владелец отношения |
| relam | oid | pg_am.oid | Если это индекс, применяемый метод доступа (B-дерево, хеш и т. д.) |
| relfilenode | oid | Имя файла на диске с этим отношением; ноль означает, что это "отображённое" представление, имя файла для которого определяется состоянием на нижнем уровне | |
| reltablespace | oid | pg_tablespace.oid | Табличное пространство, в котором хранится это отношение. Если ноль, подразумевается пространство базы данных по умолчанию. (Не имеет значения, если с отношением не связан файл на диске.) |
| relpages | int4 | Размер представления этой таблицы на диске (в страницах размера BLCKSZ). Это лишь примерная оценка, используемая планировщиком. Она обновляется командами VACUUM, ANALYZE и несколькими командами DDL, например, CREATE INDEX. | |
| reltuples | float4 | Число строк в таблице. Это лишь примерная оценка, используемая планировщиком. Она обновляется командами VACUUM, ANALYZE и несколькими командами DDL, например, CREATE INDEX. | |
| relallvisible | int4 | Число страниц, помеченных как «полностью видимые» в карте видимости таблицы. Это лишь примерная оценка, используемая планировщиком. Она обновляется командами VACUUM, ANALYZE и несколькими командами DDL, например, CREATE INDEX. | |
| reltoastrelid | oid | pg_class.oid | OID таблицы TOAST, связанной с данной таблицей, или 0, если таковой нет. В таблицу TOAST, как во вторичную, "выносятся" большие атрибуты. |
| relhasindex | bool | True, если это таблица и она имеет (или недавно имела) индексы | |
| relisshared | bool | True, если эта таблица разделяется всеми базами данных в кластере. Разделяемыми являются только некоторые системные каталоги (как например, pg_database). | |
| relpersistence | char | p = постоянная таблица (permanent), u = нежурналируемая таблица (unlogged), t = временная таблица (temporary) | |
| relkind | char | r = обычная таблица, i = индекс (index), S = последовательность (sequence), v = представление (view), m = материализованное представление (materialized view), c = составной тип (composite), t = таблица TOAST, f = сторонняя таблица (foreign) | |
| relnatts | int2 | Число пользовательских колонок в отношении (системные колонки не считаются). Столько же соответствующих строк должно быть в pg_attribute. См. также pg_attribute.attnum. | |
| relchecks | int2 | Число ограничений CHECK в таблице; см. каталог pg_constraint | |
| relhasoids | bool | True, если для каждой строки отношения генерируется OID | |
| relhaspkey | bool | True, если в таблице имеется (или имелся) первичный ключ | |
| relhasrules | bool | True, если для таблицы определены (или были определены) правила; см. каталог pg_rewrite | |
| relhastriggers | bool | True, если для таблицы определены (или были определены) триггеры; см. каталог pg_trigger | |
| relhassubclass | bool | True, если у таблицы есть (или были) потомки в иерархии наследования | |
| relispopulated | bool | True, если отношение наполнено данными (это истинно для всех отношений, кроме некоторых материализованных представлений) | |
| relreplident | char | Колонки, формирующие "идентификатор реплики" для строк: d = по умолчанию (первичный ключ, если есть), n = никакие (nothing), f = все колонки, i = индекс (index), если задано значение indisreplident, либо набор по умолчанию | |
| relfrozenxid | xid | Идентификаторы транзакций, предшествующие данному, в этой таблице заменены постоянным ("замороженным") идентификатором транзакции. Это нужно для определения, когда требуется очищать таблицу для предотвращения зацикливания идентификаторов или для сокращения объёма pg_clog. Если это отношение — не таблица, значение равно нулю (InvalidTransactionId). | |
| relminmxid | xid | Идентификаторы мультитранзакций, предшествующие данному, в этой таблице заменены другим идентификатором транзакции. Это нужно для определения, когда требуется очищать таблицу для предотвращения зацикливания идентификаторов мультитранзакций или для сокращения объёма pg_multixact. Если это отношение — не таблица, значение равно нулю (InvalidMultiXactId). | |
| relacl | aclitem[] | Права доступа; за подробностями обратитесь к описанию GRANT и REVOKE | |
| reloptions | text[] | Специальные параметры для методов доступа, в виде строк "ключ=значение" |
Некоторые логические флаги в pg_class поддерживаются не строго: гарантируется, что они будут установлены при переходе в определённое состояние, но они могут не сбрасываться немедленно, когда условия поменяются. Например, relhasindex устанавливается командой CREATE INDEX, но никогда не сбрасывается командой DROP INDEX. Вместо этого, флаг relhasindex сбрасывается командой VACUUM, если она находит, что в таблице нет индексов. Такая организация позволяет избежать состояния гонки и способствует параллельному использованию.
| Пред. | Начало | След. |
| pg_cast | Уровень выше | pg_collation |
| PostgreSQL 9.4.1 Documentation | |||
|---|---|---|---|
| Prev | Up | Chapter 48. System Catalogs | Next |
48.11. pg_class
The catalog pg_class catalogs tables and most everything else that has columns or is otherwise similar to a table. This includes indexes (but see also pg_index), sequences, 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 columns are meaningful for all relation types.
Table 48-11. pg_class Columns
| Name | Type | References | Description |
|---|---|---|---|
| oid | oid | Row identifier (hidden attribute; must be explicitly selected) | |
| relname | name | Name of the table, index, view, etc. | |
| relnamespace | oid | pg_namespace.oid | The OID of the namespace that contains this relation |
| reltype | oid | pg_type.oid | The OID of the data type that corresponds to this table's row type, if any (zero for indexes, which have no pg_type entry) |
| reloftype | oid | pg_type.oid | For typed tables, the OID of the underlying composite type, zero for all other relations |
| relowner | oid | pg_authid.oid | Owner of the relation |
| relam | oid | pg_am.oid | If this is an index, the access method used (B-tree, hash, etc.) |
| relfilenode | oid | 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 | |
| reltablespace | oid | pg_tablespace.oid | 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.) |
| relpages | int4 | Size of the on-disk representation of this table in pages (of size BLCKSZ). This is only an estimate used by the planner. It is updated by VACUUM, ANALYZE, and a few DDL commands such as CREATE INDEX. | |
| reltuples | float4 | Number of rows in the table. This is only an estimate used by the planner. It is updated by VACUUM, ANALYZE, and a few DDL commands such as CREATE INDEX. | |
| relallvisible | int4 | 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 VACUUM, ANALYZE, and a few DDL commands such as CREATE INDEX. | |
| reltoastrelid | oid | pg_class.oid | OID of the TOAST table associated with this table, 0 if none. The TOAST table stores large attributes "out of line" in a secondary table. |
| relhasindex | bool | True if this is a table and it has (or recently had) any indexes | |
| relisshared | bool | True if this table is shared across all databases in the cluster. Only certain system catalogs (such as pg_database) are shared. | |
| relpersistence | char | p = permanent table, u = unlogged table, t = temporary table | |
| relkind | char | r = ordinary table, i = index, S = sequence, v = view, m = materialized view, c = composite type, t = TOAST table, f = foreign table | |
| relnatts | int2 | Number of user columns in the relation (system columns not counted). There must be this many corresponding entries in pg_attribute. See also pg_attribute.attnum. | |
| relchecks | int2 | Number of CHECK constraints on the table; see pg_constraint catalog | |
| relhasoids | bool | True if we generate an OID for each row of the relation | |
| relhaspkey | bool | True if the table has (or once had) a primary key | |
| relhasrules | bool | True if table has (or once had) rules; see pg_rewrite catalog | |
| relhastriggers | bool | True if table has (or once had) triggers; see pg_trigger catalog | |
| relhassubclass | bool | True if table has (or once had) any inheritance children | |
| relispopulated | bool | True if relation is populated (this is true for all relations other than some materialized views) | |
| relreplident | char | Columns used to form "replica identity" for rows: d = default (primary key, if any), n = nothing, f = all columns i = index with indisreplident set, or default | |
| relfrozenxid | xid | 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 prevent transaction ID wraparound or to allow pg_clog to be shrunk. Zero (InvalidTransactionId) if the relation is not a table. | |
| relminmxid | xid | All multitransaction 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 prevent multitransaction ID ID wraparound or to allow pg_clog to be shrunk. Zero (InvalidTransactionId) if the relation is not a table. | |
| relacl | aclitem[] | Access privileges; see GRANT and REVOKE for details | |
| reloptions | text[] | Access-method-specific options, as "keyword=value" strings |
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.