Системные каталоги

Системные каталоги — это место, где система управления реляционными базами данных хранит метаданные схемы, такие как сведения о таблицах и столбцах, а также информацию о внутреннем бухгалтерском учете. Системные каталоги QHB — это обычные таблицы. Вы можете удалить и пересоздать их, добавить столбцы, вставить и обновить значения — и тем самым сильно испортить свою систему. В большинстве случаев не следует изменять системные каталоги вручную, для этого обычно существуют команды SQL. (Например, CREATE DATABASE вставляет строку в каталог pg_database и фактически создает базу данных на диске.) Есть некоторые исключения для особенно сложных операций, но многие из них с течением времени становятся доступны в виде команд SQL, и поэтому необходимость в прямом манипулировании системными каталогами постоянно уменьшается.

• Обзор
  • pg_aggregate
  • pg_am
  • pg_amop
  • pg_amproc
  • pg_attrdef
  • pg_attribute
  • pg_authid
  • pg_auth_members
  • pg_cast
  • pg_class
  • pg_collation
  • pg_constraint
  • pg_conversion
  • pg_database
  • pg_db_role_setting
  • pg_default_acl
  • pg_depend
  • pg_description
  • pg_enum
  • pg_event_trigger
  • pg_extension
  • pg_foreign_data_wrapper
  • pg_foreign_server
  • pg_foreign_table
  • pg_index
  • pg_inherits
  • pg_init_privs
  • pg_language
  • pg_largeobject
  • pg_largeobject_metadata
  • pg_namespace
  • pg_opclass
  • pg_operator
  • pg_opfamily
  • pg_partitioned_table
  • pg_policy
  • pg_proc
  • pg_publication
  • pg_publication_rel
  • pg_range
  • pg_replication_origin
  • pg_rewrite
  • pg_seclabel
  • pg_sequence
  • pg_shdepend
  • pg_shdescription
  • pg_shseclabel
  • pg_statistic
  • pg_statistic_ext
  • pg_statistic_ext_data
  • pg_subscription
  • pg_subscription_rel
  • pg_tablespace
  • pg_transform
  • pg_trigger
  • pg_ts_config
  • pg_ts_config_map
  • pg_ts_dict
  • pg_ts_parser
  • pg_ts_template
  • pg_type
  • pg_user_mapping
• Системные представления
  • pg_available_extensions
  • pg_available_extension_versions
  • pg_config
  • pg_cursors
  • pg_file_settings
  • pg_group
  • pg_hba_file_rules
  • pg_indexes
  • pg_locks
  • pg_matviews
  • pg_policies
  • pg_prepared_statements
  • pg_prepared_xacts
  • pg_publication_tables
  • pg_replication_origin_status
  • pg_replication_slots
  • pg_roles
  • pg_rules
  • pg_seclabels
  • pg_sequences
  • pg_settings
  • pg_shadow
  • pg_stats
  • pg_stats_ext
  • pg_tables
  • pg_timezone_abbrevs
  • pg_timezone_names
  • pg_user
  • pg_user_mappings
  • pg_views

Обзор

В таблице Системные каталоги перечислены системные каталоги. Более подробная документация по каждому каталогу приводится ниже.

Большинство системных каталогов копируются из шаблона базы данных во время ее создания и затем зависят от конкретной базы данных. Несколько каталогов физически совместно используются во всех базах данных в кластере — они отмечаются в описаниях отдельных каталогов.

pg_aggregate

В каталоге pg_aggregate хранится информация об агрегатных функциях. Агрегатная функция — это функция, которая работает с набором значений (как правило, с одним столбцом из каждой строки, которая соответствует условию запроса) и возвращает одно значение, вычисленное из всех этих значений. Типичными агрегатными функциями являются sum, count и max. Каждая запись внутри pg_aggregate представляет собой расширение записи в pg_proc. Запись в pg_proc содержит имя агрегата, типы входных и выходных данных, а также другую информацию, аналогичную имеющейся у обычных функций.

Таблица: Столбцы pg_aggregate

Новые агрегатные функции регистрируются с помощью команды CREATE AGGREGATE. Дополнительную информацию о написании агрегатных функций и значении функций перехода см. в разделе Пользовательские агрегаты.

pg_am

В каталоге pg_am хранится информация о методах доступа к отношениям. Для каждого метода доступа, поддерживаемого системой, существует одна строка. В настоящее время только таблицы и индексы имеют методы доступа. Требования к методам доступа к таблицам и индексам подробно рассматриваются в главах Интерфейс доступа к таблице и Интерфейс доступа индекса соответственно.

Таблица: Столбцы pg_am

Примечание
Данные о свойствах индексных методов доступа напрямую видны только на уровне кода С. Однако запросы SQL могут проверять эти свойства с помощью pg_index_column_has_property() и связанных функций.

pg_amop

В каталоге pg_amop хранится информация об операторах, связанных с семействами операторов метода доступа. Для каждого оператора, который является членом семейства операторов, существует одна строка. Членом семейства может быть либо оператор поиска, либо оператор упорядочивания. Оператор может принадлежать нескольким семействам, но в пределах одного семейства не может находиться более чем в одной позиции поиска или позиции упорядочивания. (Допустимо, хотя и маловероятно, что оператор будет использоваться как для поиска, так и для сравнения.)

Таблица: Столбцы pg_amop

Запись оператора «поиска» указывает, что индекс этого семейства операторов может быть использован для поиска всех строк, удовлетворяющих требованию WHERE столбец_индекса оператор константа. Очевидно, что такой оператор должен вернуть тип boolean, а тип его левого операнда должен соответствовать типу данных столбца индекса.

Запись оператора «упорядочивания» указывает, что индекс этого семейства операторов может быть отсканирован для возврата строк в порядке, представленном ORDER BY столбец_индекса оператор константа. Такой оператор может возвращать любой сортируемый тип данных, хотя, опять же, тип его левого операнда должен соответствовать типу данных столбца индекса. Точная семантика выражения ORDER BY определяется по столбцу amopsortfamily, который должен указывать на семейство операторов B-дерева для типа, возвращаемого оператором.

Примечание
В настоящее время предполагается, что порядок сортировки для оператора упорядочивания является значением по умолчанию для указанного семейства операторов, т. е. ASC NULLS LAST. Возможно, когда-нибудь для придания большей гибкости будут добавлены дополнительные столбцы, чтобы явно указать параметры сортировки.

Поле amopmethod в записи оператора должно соответствовать полю opfmethod содержащего его семейства операторов (в данном случае включение amopmethod является преднамеренной денормализацией структуры каталога из соображений производительности). Кроме того, поля amoplefttype и amoprighttype должны соответствовать полям oprleft и oprright соответствующей записи в pg_operator.

pg_amproc

В каталоге pg_amproc хранится информация о функциях, поддерживаемых оператором и связанных с семействами операторов метода доступа. Для каждой вспомогательной функции, принадлежащей семейству операторов, существует одна строка.

Таблица: Столбцы pg_amproc

Обычная интерпретация полей amproclefttype и amprocrighttype состоит в том, что они определяют типы левого и правого операнда оператора(ов), который(ые) поддерживает определенная вспомогательная функция. Для некоторых методов доступа они соответствуют типу(ам) входных данных самой вспомогательной функции, для других — нет. Существует такое понятие, как вспомогательные функции для индекса «по умолчанию». Это функции, у которых amproclefttype и amprocrighttype равны opcintype класса операторов индекса.

pg_attrdef

В каталоге pg_attrdef хранятся значения столбца по умолчанию. Основная информация о столбцах находится в каталоге pg_attribute. В этом каталоге хранятся только те столбцы, для которых было явно установлено значение по умолчанию.

Таблица: Столбцы pg_attrdef

pg_attribute

В каталоге pg_attribute хранится информация о столбцах таблицы. Для каждого столбца в каждой таблице базы данных будет храниться ровно одна строка pg_attribute. (Также будут храниться записи атрибутов для индексов и всех объектов, которые имеют записи в pg_class).

Термин «атрибут» равнозначен столбцу и используется по историческим причинам.

Таблица: Столбцы pg_attribute

В записи удаленного(ых) столбца(ов) pg_attribute поле atttypid сбрасывается до нуля, но поле attlen и остальные поля, скопированные из pg_type все еще действительны. Это необходимо, чтобы справиться с ситуацией, когда после удаления столбца удаляется и его тип данных, и поэтому соответствующей строки pg_type тоже нет. Поле attlen и остальные поля можно использовать для интерпретации содержимого строки таблицы.

pg_authid

В каталоге pg_authid хранится информация об идентификаторах авторизации базы данных (ролях). Роль включает в себя понятия «пользователи» и «группы». Пользователь — это просто роль с установленным флагом rolcanlogin. Любая роль (с rolcanlogin или без него) может иметь другие роли в качестве членов; см. описание каталога pg_auth_members.

Поскольку этот каталог содержит пароли, он не должен быть общедоступным. pg_roles — это публично доступное представление на базе pg_authid, которое скрывает поле пароля.

В главе Роли в базе данных содержатся подробные сведения об управлении пользователями и их правами.

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

Таблица: Столбцы pg_authid

Для пароля, зашифрованного MD5, столбец rolpassword будет начинаться со строки md5, за которой следует 32-символьный шестнадцатеричный хэш MD5. Хэш MD5 будет содержать пароль пользователя, связанный с его именем. Например, если пользователь joe имеет пароль xyzzy, QHB будет хранить хэш md5 строки xyzzyjoe.

Если пароль зашифрован с помощью SCRAM-SHA-256, он имеет следующий формат:

SCRAM-SHA-256$<число итераций>:<соль>$<СохраненныйКлюч>:<КлючСервера>

где соль, СохраненныйКлюч и КлючСервера кодируются в формате Base64. Этот формат совпадает с форматом, указанным в документе RFC 5803.

Пароль, который не соответствует ни одному из этих форматов, считается незашифрованным.

pg_auth_members

В каталоге pg_auth_members представлены отношения членства между ролями. Допускается любой нециклический набор отношений.

Поскольку авторизация пользователей является кластерной, pg_auth_members является общим каталогом для всех баз данных кластера: существует только одна копия pg_auth_members на кластер, а не для каждой базы данных.

Таблица: Столбцы pg_auth_members

pg_cast

В каталоге pg_cast хранятся как встроенные, так и определяемые пользователем пути преобразования типов данных.

Следует отметить, что pg_cast содержит не все преобразования типов, которые система умеет выполнять, а только те, которые нельзя вывести из некоторого общего правила. Например, приведение между доменом и его базовым типом в pg_cast явно не представлено. Еще одним важным исключением является то, что в каталоге pg_cast явно не представлены «автоматические приведения преобразования ввода-вывода», которые выполняются, используя для преобразования в/из text или других строковых типов собственные функции ввода-вывода типа данных.

Таблица: Столбцы pg_cast

Функции приведения, перечисленные в pg_cast, должны всегда принимать исходный тип приведения в качестве типа первого аргумента и возвращать результат, имеющий целевой тип приведения. Функция приведения может иметь до трех аргументов. Второй аргумент, если он присутствует, должен иметь тип integer; он получает модификатор типа, связанный с целевым типом, или -1, если модификатора нет. Третий аргумент, если он присутствует, должен иметь тип boolean; он получает значение true, если приведение является явным, в противном случае — false.

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

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

pg_class

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

Таблица: Столбцы pg_class

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

pg_collation

В каталоге pg_collation описываются доступные правила сортировки, которые в сущности представляют собой сопоставления между именем SQL и категориями локали операционной системы. Дополнительную информацию см. в разделе Поддержка правил сортировки.

Таблица: Столбцы pg_collation

Обратите внимание, что уникальными ключами в этом каталоге являются (collname, collencoding, collnamespace), а не только (collname, collnamespace). QHB обычно игнорирует все правила сортировки, которые не имеют collencoding равным либо кодировке текущей базы данных, либо -1; кроме того, создание новых записей с тем же именем, что и запись с collencoding = -1, запрещено. Поэтому для определения правила сортировки достаточно использовать полное имя SQL (schema.name), даже если оно не является уникальным в соответствии с определением каталога. Такое определение каталога обусловлено тем, что во время инициализации кластера qhb_bootstrap заполняет его записями для всех доступных в системе локалей, поэтому каталог должен иметь возможность хранить записи для всех кодировок, которые могут когда-либо использоваться в кластере.

В базе данных template0 может быть полезно создать правила сортировки, кодировка которых не соответствует кодировке базы данных, так как они могут соответствовать кодировкам баз данных, впоследствии клонированных из template0. В настоящее время это придется сделать вручную.

pg_constraint

В каталоге pg_constraint хранятся проверочные и исключающие ограничения, ограничения уникальности, первичного и внешнего ключей для таблиц. (Ограничения столбцов не обрабатываются отдельно. Каждое ограничение столбца эквивалентно некоторому ограничению таблицы.) Ограничения NOT NULL представлены не здесь, а в каталоге pg_attribute.

Определяемые пользователем триггеры ограничений (созданные с помощью команды CREATE CONSTRAINT TRIGGER) также приводят к появлению записи в этой таблице.

Также здесь хранятся проверочные ограничения для доменов.

Таблица: Столбцы pg_constraint

В случае исключающего ограничения столбец conkey полезен только для элементов ограничения, которые являются простыми ссылками на столбец. Для других случаев значение conkey будет равно NULL, и чтобы обнаружить выражение, определяющее ограничение, необходимо просмотреть связанный индекс. (Следовательно, поле conkey имеет то же содержание, что и pg_index.indkey для индекса.)

Примечание
pg_class.relchecks необходимо согласовать с количеством записей проверочного ограничения, найденных в этой таблице для каждого отношения.

pg_conversion

В каталоге pg_conversion описаны функции преобразования кодировки. Дополнительную информацию см. в описании команды CREATE CONVERSION.

Таблица: Столбцы pg_conversion

pg_database

В каталоге pg_database хранится информация о доступных базах данных. Базы данных создаются с помощью команды CREATE DATABASE. Дополнительную информацию о значении некоторых параметров см. в главе Управление базами данных.

В отличие от большинства системных каталогов, pg_database является общим для всех баз данных кластера: существует только одна копия pg_database на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_database

pg_db_role_setting

В каталоге pg_db_role_setting хранятся значения по умолчанию, заданные для переменных конфигурации времени выполнения, для каждой комбинации роли и базы данных.

В отличие от большинства системных каталогов, pg_db_role_setting является общим для всех баз данных кластера: существует только одна копия pg_db_role_setting на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_db_role_setting

pg_default_acl

В каталоге pg_default_acl сохраняются права, изначально присваиваемые только что созданным объектам.

Таблица: Столбцы pg_default_acl

Запись в pg_default_acl показывает начальные права, которые будут присвоены объекту, принадлежащему указанному пользователю. В настоящее время существует два типа записей: «глобальные» записи с defaclnamespace = 0 и записи «схемы», ссылающиеся на конкретную схему. Если глобальная запись присутствует, то она переопределяет обычные фиксированные права по умолчанию для типа объекта. Запись схемы, если она присутствует, представляет права, которые будут добавлены к глобальным или фиксированным правам по умолчанию.

Обратите внимание, что если запись ACL в другом каталоге имеет значение NULL, то она используется для представления фиксированных прав по умолчанию для ее объекта, а не тех, которые могут находиться в pg_default_acl в данный момент. Каталог pg_default_acl считывается только во время создания объекта.

pg_depend

В каталог pg_depend записываются отношения зависимости между объектами базы данных. Эта информация позволяет командам DROP находить, какие другие объекты должны быть удалены с помощью DROP CASCADE, или предотвращать удаление в случае DROP RESTRICT.

См. также описание каталога pg_shdepend, который выполняет аналогичную функцию для зависимостей, включающих объекты, совместно используемые в кластере баз данных.

Таблица: Столбцы pg_depend

Во всех случаях запись в pg_depend указывает, что ссылочный объект не может быть удален без удаления также зависимого объекта. Тем не менее, есть несколько подвидов зависимостей, задаваемых с помощью deptype:

DEPENDENCY_NORMAL (n)

Обычное отношение между раздельно созданными объектами. Зависимый объект можно удалить, не затрагивая ссылочный объект. Последний может быть удален только путем указания CASCADE, и в этом случае зависимый объект также удаляется. Пример: столбец таблицы имеет нормальную зависимость от своего типа данных.

DEPENDENCY_AUTO (a)

Зависимый объект может быть удален отдельно от ссылочного и должен быть автоматически удален (вне зависимости от режима RESTRICT или CASCADE). Пример: именованное ограничение для таблицы становится автоматически зависимым от таблицы, поэтому оно исчезнет автоматически, если таблица будет удалена.

DEPENDENCY_INTERNAL (i)

Зависимый объект был создан как часть ссылочного и на самом деле является только частью его внутренней реализации. Удаление такого зависимого объекта напрямую при помощи DROP будет запрещено (вместо этого пользователю будет выдано сообщение о том, что необходимо вызвать DROP для ссылочного объекта). Удаление ссылочного объекта приведет к автоматическому удалению зависимого объекта без учета того, указывается ли CASCADE при удалении или нет. Если зависимый объект должен быть удален из-за зависимости от какого-либо другого удаляемого объекта, его удаление преобразуется в удаление ссылочного объекта, поэтому зависимости NORMAL и AUTO зависимого объекта ведут себя так же, как и зависимости ссылочного объекта. Пример: правило ON SELECT для представления становится внутренне зависимым от этого представления, предотвращая его удаление, пока то остается в системе. Зависимости для этого правила (например, таблицы, на которые оно ссылается) действуют так, как если бы они были зависимостями представления.

DEPENDENCY_PARTITION_PRI (P) DEPENDENCY_PARTITION_SEC (S)

Зависимый объект был создан как часть создания ссылочного объекта и на самом деле является только частью его внутренней реализации; однако, в отличие от INTERNAL, существует более одного такого ссылочного объекта. Зависимый объект не должен быть удален, пока не будет удален хотя бы один из этих объектов; если какой-либо из них удаляется, зависимый объект должен быть удален вне зависимости от указания CASCADE. Также, в отличие от INTERNAL, удаление некоторого другого объекта, от которого зависит объект, не приводит к автоматическому удалению какого-либо ссылочного объекта партиции. Следовательно, если удаление каскадно не доходит хотя бы до одного из этих объектов каким-то другим способом, оно не произойдет. (В большинстве случаев зависимый объект совместно использует все свои не связанные с партициями зависимости, по крайней мере, с одним ссылочным объектом партиции, так что это ограничение не приведет к блокированию каскадного удаления.) Первичные (PRI) и вторичные (SEC) зависимости партиций ведут себя одинаково, за исключением того, что первичная зависимость предпочтительна для использования в сообщениях об ошибках — следовательно, объект, зависящий от партиции, должен иметь одну первичную зависимость партиции и одну или несколько вторичных зависимостей партиции. Обратите внимание, что зависимости партиций создаются в дополнение к любым зависимостям, которые обычно имеются у объекта, а не вместо них. Это упрощает операции ATTACH/DETACH PARTITION: необходимо только добавить или удалить зависимости партиции. Пример: дочерний партиционированный индекс становится партиционно-зависимым как от своей партиционированной таблицы, так и от родительского партиционированного индекса, поэтому он будет удален при удалении любого из этих объектов, но не в других случаях. Зависимость от родительского индекса является первичной, так что если пользователь попытается удалить дочерний партиционированный индекс, сообщение об ошибке будет предлагать вместо этого удалить родительский индекс (а не таблицу).

DEPENDENCY_EXTENSION (е)

Зависимый объект является элементом расширения, на которое ссылается объект (см. раздел pg_extension). Зависимый объект можно удалить только с помощью DROP EXTENSION для ссылочного объекта. Функционально этот тип зависимости действует так же, как и зависимость INTERNAL, но он хранится отдельно для ясности и упрощения qhb_dump.

DEPENDENCY_AUTO_EXTENSION (x)

Зависимый объект не является элементом расширения, на которое ссылается объект (и поэтому он не должен игнорироваться qhb_dump), но он не может функционировать без расширения и должен автоматически удаляться при удалении расширения. Зависимый объект также может быть удален сам по себе. Функционально этот тип зависимости действует так же, как и зависимость AUTO, но она хранится отдельно для ясности и упрощения qhb_dump.

DEPENDENCY_PIN (p)

Зависимого объекта нет. Этот тип записи означает, что сама система зависит от ссылочного объекта, и поэтому этот объект никогда не должен быть удален. Записи этого типа создаются только в команде qhb_bootstrap. Столбцы для зависимого объекта содержат нули.

Обратите внимание, что два объекта вполне могут быть связаны более чем одной записью в pg_depend. Например, дочерний партиционированный индекс будет иметь зависимость партиционного типа от связанной партиционированной таблицы и автозависимость от каждого столбца той таблицы, которую он индексирует. Такая ситуация выражает объединение семантики множественной зависимости. Зависимый объект можно удалить без указания CASCADE, если какая-либо из его зависимостей удовлетворяет его условию автоматического удаления. И наоборот, должны быть выполнены все ограничения зависимостей, определяющие, какие объекты должны быть удалены вместе.

pg_description

В каталоге pg_description хранятся дополнительные описания (комментарии) для каждого объекта базы данных. Описания можно обрабатывать с помощью команды COMMENT и просматривать с помощью команд qsql \d.

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

Таблица: Столбцы pg_description

pg_enum

Каталог pg_enum содержит записи, показывающие значения и текстовые метки для всех типов-перечислений. Внутренним представлением заданного значения перечисления в действительности является OID соответствующей ему строки в pg_enum.

Таблица: Столбцы pg_enum

OID для строк в pg_enum следуют специальному правилу: четные OID гарантированно упорядочиваются аналогично порядку сортировки их типа-перечисления. То есть если два четных OID принадлежат к одному и тому же типу-перечислению, меньший OID должен иметь меньшее значение enumsortorder. Нечетные значения OID могут быть никак не связаны с порядком сортировки. Это правило во многих случаях позволяет подпрограммам сравнения перечислений обходиться без поиска в каталоге. Подпрограммы, которые создают и изменяют типы-перечисления, по возможности пытаются назначать значениям перечислений четный OID.

При создании типа-перечисления его членам присваиваются позиции по порядку сортировки 1..n. Но элементам, добавляемым позже, могут присваиваться отрицательные или дробные значения enumsortorder. Единственное требование к этим значениям в том, чтобы они были правильно упорядочены и уникальны в каждом типе-перечислении.

pg_event_trigger

В каталоге pg_event_trigger хранятся триггеры событий. Дополнительную информацию см. в главе Триггеры событий.

Таблица: Столбцы pg_event_trigger

pg_extension

Каталог pg_extension сохраняет информацию об установленных расширениях. Подробную информацию о расширениях см. в разделе Упаковка связанных объектов в расширение.

Таблица: Столбцы pg_extension

Обратите внимание, что, в отличие от большинства каталогов со столбцом «namespace», столбец extnamespace не должен означать, что расширение принадлежит к этой схеме. Имена расширений никогда не определяются схемой. Скорее, extnamespace указывает схему, содержащую большинство или все объекты расширения. Если extrelocatable имеет значение true, то эта схема фактически должна содержать все определяемые схемой объекты, принадлежащие данному расширению.

pg_foreign_data_wrapper

В каталоге pg_foreign_data_wrapper хранятся определения оберток сторонних данных. Обертки сторонних данных — это механизм, с помощью которого осуществляется доступ к внешним данным, находящимся на сторонних серверах.

Таблица: Столбцы pg_foreign_data_wrapper

pg_foreign_server

В каталоге pg_foreign_server хранятся определения сторонних серверов. Сторонний сервер описывает источник внешних данных, например удаленный сервер. Доступ к сторонним серверам осуществляется через обертки сторонних данных.

Таблица: Столбцы pg_foreign_server

pg_foreign_table

Каталог pg_foreign_table содержит дополнительную информацию о сторонних таблицах. Сторонняя таблица в основном представлена записью в каталоге pg_class, как и обычная таблица. Запись, соответствующая ей в pg_foreign_table, содержит информацию, относящуюся только к сторонним таблицам, а не к какому-либо другому виду отношений.

Таблица: Столбцы pg_foreign_table

pg_index

Каталог pg_index содержит часть информации об индексах. Остальное находится по большей части в каталоге pg_class.

Таблица: Столбцы pg_index

pg_inherits

В каталог pg_inherits записывается информация об иерархиях наследования таблицы и индекса. Для каждой прямой связи «родитель-потомок» таблицы или индекса в базе данных существует одна запись. (Косвенное наследование можно определить, проследив цепочки записей.)

Таблица: Столбцы pg_inherits

pg_init_privs

В каталог pg_init_privs записывается информация об изначальных правах объектов в системе. Для каждого объекта в базе данных, имеющего нестандартный (отличный от NULL) начальный набор прав, существует одна запись.

Начальные права объектов могут задаваться либо при инициализации системы (с помощью qhb_bootstrap), либо при создании объекта в процессе выполнения команды CREATE EXTENSION, а скрипт расширения устанавливает начальные права с помощью системы GRANT. Обратите внимание, что эта система автоматически записывает права во время выполнения скрипта расширения, поэтому авторам расширения достаточно использовать в своем скрипте только команды GRANT и REVOKE, чтобы права были записаны. Столбец privtype указывает, было ли начальное право установлено программой qhb_bootstrap или в процессе выполнения команды CREATE EXTENSION.

Объекты с начальными правами, установленными qhb_bootstrap, будут иметь записи, где privtype помечается буквой 'i', тогда как у объектов с начальными правами, установленными CREATE EXTENSION, privtype будет помечаться буквой 'e'.

Таблица: Столбцы pg_init_privs

pg_language

В каталоге pg_language регистрируются языки, на которых можно писать функции или хранимые процедуры. Дополнительную информацию об обработчиках языка см. в описании команды CREATE LANGUAGE и главе Процедурные языки.

Таблица: Столбцы pg_language

pg_largeobject

Каталог pg_largeobject содержит данные, составляющие «большие объекты». Большой объект идентифицируется OID, назначенным при его создании. Каждый большой объект разбивается на сегменты или «страницы», достаточно маленькие для удобного хранения в виде строк в pg_largeobject. Количество данных на странице определяется как LOBLKSIZE (который в настоящее время равен BLCKSZ/4, т. е. обычно 2 Кб).

Для получения списка OID больших объектов следует обратиться к pg_largeobject_metadata.

Таблица: Столбцы pg_largeobject

Каждая строка pg_largeobject содержит данные для одной страницы большого объекта, начиная со смещения (pageno * LOBLKSIZE) внутри него в байтах. Эта реализация допускает разреженное хранилище: страницы могут отсутствовать и быть короче LOBLKSIZE, даже если они не являются последней страницей объекта. Отсутствующие области внутри большого объекта считываются как нули.

pg_largeobject_metadata

Каталог pg_largeobject_metadata содержит метаданные, связанные с большими объектами. Фактические данные большого объекта хранятся в каталоге pg_largeobject.

Таблица: Столбцы pg_largeobject_metadata

pg_namespace

В каталоге pg_namespace хранятся пространства имен. Пространство имен — это структура, лежащая в основе схем SQL: каждое пространство имен без конфликтов может иметь отдельный набор отношений, типов и т. д.

Таблица: Столбцы pg_namespace

pg_opclass

Каталог pg_opclass определяет классы операторов метода доступа к индексу. Каждый класс операторов определяет семантику для индексных столбцов определенного типа данных и конкретного метода доступа к индексам. Класс оператора по существу определяет, что конкретное семейство операторов применимо к конкретному типу данных индексируемого столбца. Набор операторов из семейства, которые на самом деле можно использовать с индексированным столбцом, составляет те, что принимают в качестве левого операнда тип данных столбца.

Классы операторов подробно описаны в разделе Интерфейсные расширения для индексов.

Таблица: Столбцы pg_opclass

Значение opfmethod класса операторов должно совпадать с таковым у содержащего его семейства операторов. Кроме того, в pg_opclass должно быть не более одной строки, в которой opcdefault равно true для любой заданной комбинации opcmethod и opcintype.

pg_operator

В каталоге pg_operator хранится информация об операторах. Дополнительную информацию см. в описании команды CREATE OPERATOR и разделе Пользовательские операторы.

Таблица: Столбцы pg_operator

Неиспользуемые столбцы содержат нули. Например, поле oprleft содержит ноль для префиксного оператора.

pg_opfamily

Каталог pg_opfamily определяет семейства операторов. Каждое семейство операторов представляет собой набор операторов и связанных с ними вспомогательных процедур, реализующих семантику, заданную для конкретного метода доступа к индексу. Более того, все операторы в семействе «совместимы» в том смысле, который определяется методом доступа. Концепция семейства операторов позволяет применять с индексами операторы разного типа и рассуждать о них, используя знания о семантике метода доступа.

Семейства операторов подробно описаны в разделе Интерфейсные расширения для индексов.

Таблица: Столбцы pg_opfamily

Большая часть информации, определяющей семейство операторов, находится не в строке pg_opfamily, а в связанных строках в каталогах pg_amop, pg_amproc и pg_opclass.

pg_partitioned_table

В каталоге pg_partitioned_table хранится информация о способе партиционирования таблиц.

Таблица: Столбцы pg_partitioned_table

pg_policy

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

Таблица: Столбцы pg_policy

Примечание
Политики, хранящиеся в каталоге pg_policy, применяются только тогда, когда для их таблицы задано свойство pg_class.relrowsecurity.

pg_proc

В каталоге pg_proc хранится информация о простых функциях, процедурах, агрегатных и оконных функциях (в совокупности также известных как подпрограммы). Дополнительную информацию см. в описаниях команд CREATE FUNCTION и CREATE PROCEDURE и разделе Пользовательские функции.

Если prokind указывает, что эта запись предназначена для агрегатной функции, в каталоге pg_aggregate должна быть соответствующая строка.

Таблица: Столбцы pg_proc

Для скомпилированных функций, как встроенных, так и динамически загружаемых, поле prosrc содержит имя функции на языке C (объектную ссылку). Для всех других известных на данный момент типов языков prosrc содержит исходный текст функции. Поле probin используется только для динамически загружаемых функций на языке C/RUST, для которых он дает имя файла разделяемой библиотеки, содержащей эти функции.

pg_publication

Каталог pg_publication содержит все публикации для логической репликации, созданные в базе данных.

Таблица: Столбцы pg_publication

pg_publication_rel

Каталог pg_publication_rel содержит сопоставления между отношениями и публикациями в базе данных. Это сопоставления вида многие-ко-многим. Более понятное пользователю представление этой информации можно также посмотреть в подразделе pg_publication_tables.

Таблица: Столбцы pg_publication_rel

pg_range

В каталоге pg_range хранится информация о типах диапазонов. Это дополнительная информация к записям типов в каталоге pg_type.

Таблица: Столбцы pg_range

Значение поля rngsubopc (плюс rngcollation, если тип элемента является сортируемым) определяет правило сортировки, используемое типом диапазона. Значение поля rngcanonic используется, когда тип элемента является дискретным. Значение поля rngsubdiff является необязательным, но его стоит задавать для повышения производительности индексов GiST с диапазонным типом.

pg_replication_origin

Каталог pg_replication_origin содержит все созданные источники репликации.

В отличие от большинства системных каталогов, pg_replication_origin является общим для всех баз данных кластера: существует только одна копия pg_replication_origin на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_replication_origin

pg_rewrite

В каталоге pg_rewrite хранятся правила перезаписи для таблиц и представлений.

Таблица: Столбцы pg_rewrite

Примечание
Если таблица имеет какие-либо правила в этом каталоге, поле pg_class.relhasrules должно содержать true.

pg_seclabel

В каталоге pg_seclabel хранятся метки безопасности для объектов базы данных. Метками безопасности можно управлять с помощью команды SECURITY LABEL. Более простой способ просмотра меток безопасности описан в подразделе pg_seclabels. См. также описание каталога pg_shseclabel, который выполняет ту же функцию для меток безопасности объектов базы данных, совместно используемых в кластере баз данных.

Таблица: Столбцы pg_seclabel

pg_sequence

Каталог pg_sequence содержит информацию о последовательностях. Некоторые сведения о последовательностях, такие как имя и схема, находятся в каталоге pg_class.

Таблица: Столбцы pg_sequence

pg_shdepend

В каталог pg_shdepend записываются отношения зависимости между объектами базы данных и общими объектами, такими как роли. Эта информация позволяет QHB перед попыткой удаления этих объектов убедиться в том, что они не используются.

См. также описание каталога pg_depend, который выполняет ту же функцию для зависимостей объектов в пределах одной базы данных.

В отличие от большинства системных каталогов, pg_shdepend является общим для всех баз данных кластера: существует только одна копия pg_shdepend на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_shdepend

Во всех случаях запись в pg_shdepend указывает, что ссылочный объект нельзя удалить, не удалив также зависимый объект. Однако есть несколько подвидов зависимостей, которые задаются в поле deptype:

SHARED_DEPENDENCY_OWNER (о)

Ссылочный объект (который должен быть ролью) является владельцем зависимого объекта.

SHARED_DEPENDENCY_ACL (a)

Ссылочный объект (который должен быть ролью) упоминается в списке ACL (список управления доступом (access control list), т. е. список прав) зависимого объекта. (Запись SHARED_DEPENDENCY_ACL не создается для владельца объекта, так как у владельца в любом случае будет запись SHARED_DEPENDENCY_OWNER.)

SHARED_DEPENDENCY_POLICY (r)

Ссылочный объект (который должен быть ролью) является целью для объекта зависимой политики.

SHARED_DEPENDENCY_PIN (p)

Зависимый объект отсутствует; этот тип записи служит сигналом, что сама система зависит от ссылочного объекта, и поэтому этот объект никогда не должен быть удален. Записи этого типа создаются только командой qhb_bootstrap. Столбцы для зависимого объекта у этой записи содержат нули.

SHARED_DEPENDENCY_TABLESPACE (t)

Зависимый объект (который должен быть табличным пространством) упоминается в качестве табличного пространства в отношении, у которого нет хранилища.

В будущем могут потребоваться и другие подвиды зависимостей. В частности, обратите внимание, что в текущем определении ссылочными объектами могут быть только роли и табличные пространства.

pg_shdescription

В каталоге pg_shdescription хранятся необязательные описания (комментарии) для общих объектов базы данных. Описаниями можно манипулировать с помощью команды COMMENT и просматривать с помощью команд qsql \d.

См. также описание каталога pg_description, который выполняет ту же функцию для описаний объектов в пределах одной базы данных.

В отличие от большинства системных каталогов, pg_shdescription является общим для всех баз данных кластера: существует только одна копия pg_shdescription на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_shdescription

pg_shseclabel

В каталоге pg_shseclabel хранятся метки безопасности на общих объектах базы данных. Метками безопасности можно управлять с помощью команды SECURITY LABEL. Более простой способ просмотра меток безопасности описан в подразделе pg_seclabels.

См. также описание каталога pg_seclabel, который выполняет ту же функцию для меток безопасности объектов в пределах одной базы данных.

В отличие от большинства системных каталогов, pg_shseclabel является общим для всех баз данных кластера: существует только одна копия pg_shseclabel на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_shseclabel

pg_statistic

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

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

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

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

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

Таблица: Столбцы pg_statistic

pg_statistic_ext

Каталог pg_statistic_ext содержит определения расширенной статистики планировщика. Каждая строка в этом каталоге соответствует объекту статистики, созданному с помощью команды CREATE STATISTICS.

Таблица: Столбцы pg_statistic_ext

Запись в pg_statistic_ext полностью заполняется во время выполнения команды CREATE STATISTICS, но фактические статистические значения при этом не вычисляются. Последующие команды ANALYZE вычисляют требуемые значения и заполняют запись в каталоге pg_statistic_ext_data.

pg_statistic_ext_data

Каталог pg_statistic_ext_data содержит данные для расширенной статистики планировщика, определенной в pg_statistic_ext. Каждая строка в этом каталоге соответствует объекту статистики, созданному командой CREATE STATISTICS.

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

Таблица: Столбцы pg_statistic_ext_data

pg_subscription

Каталог pg_subscription содержит все существующие подписки на логическую репликацию.

В отличие от большинства системных каталогов, pg_subscription является общим для всех баз данных кластера: существует только одна копия pg_subscription на кластер, а не по одному на каждую базу данных.

Обычным пользователям запрещен доступ к столбцу subconninfo, поскольку он может содержать простые текстовые пароли.

Таблица: Столбцы pg_subscription

pg_subscription_rel

Каталог pg_subscription_rel содержит состояние для каждого реплицируемого отношения в каждой подписке. Это сопоставление вида многие-ко-многим.

Этот каталог содержит только таблицы, известные подписке после выполнения команды CREATE SUBSCRIPTION или ALTER SUBSCRIPTION ... REFRESH PUBLICATION.

Таблица: Столбцы pg_subscription_rel

pg_tablespace

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

В отличие от большинства системных каталогов, pg_tablespace является общим для всех баз данных кластера - существует только одна копия pg_tablespace на кластер, а не по одному на каждую базу данных.

Таблица: Столбцы pg_tablespace

pg_transform

В каталоге pg_transform хранится информация о преобразованиях, которые являются механизмом адаптации типов данных к процедурным языкам. Дополнительную информацию см. в описании команды CREATE TRANSFORM.

Таблица: Столбцы pg_transform

pg_trigger

Каталог pg_trigger содержит информацию о триггерах в таблицах и представлениях. Дополнительную информацию см. в описании команды CREATE TRIGGER.

Таблица: Столбцы pg_trigger

В настоящее время триггеры, относящиеся к столбцам, поддерживаются только для событий UPDATE, поэтому поле tgattr актуально только для этого типа событий. tgtype может также содержать биты для других типов событий, но считается, что они распространяются только на таблицы, независимо от значения поля tgattr.

Примечание
Когда поле tgconstraint имеет отличное от нуля значение, поля tgconstrrelid, tgconstrindid, tgdeferrable и tginitdeferred в основном дублируют ссылочную запись в pg_constraint. Тем не менее, неоткладываемый триггер может быть связан с откладываемым ограничением: ограничения внешнего ключа могут иметь и откладываемые, и неоткладываемые триггеры.

Примечание
если отношение имеет какие-либо триггеры в этом каталоге, поле pg_class.relhastriggers должно иметь значение true.

pg_ts_config

Каталог pg_ts_config содержит записи, представляющие конфигурации текстового поиска. Конфигурация задает определенный синтаксический анализатор текстового поиска и список словарей, которые будут использоваться для каждого из типов выходных фрагментов синтаксического анализатора. Анализатор хранится в записи pg_ts_config, но сопоставление фрагмент-словарь определяется подчиненными записями в pg_ts_config_map.

Таблица: Столбцы pg_ts_config

pg_ts_config_map

Каталог pg_ts_config_map содержит записи, показывающие, к каким словарям текстового поиска следует обращаться и в каком порядке, для каждого типа фрагмента, выдаваемого синтаксическим анализатором каждой конфигурации текстового поиска.

Таблица: Столбцы pg_ts_config_map

pg_ts_dict

Каталог pg_ts_dict содержит записи, определяющие словари текстового поиска. Словарь зависит от шаблона текстового поиска, который задает все необходимые функции реализации; сам словарь предоставляет значения для настраиваемых пользователем параметров, поддерживаемых шаблоном. Такое разделение позволяет создавать словари непривилегированным пользователям. Параметры задаются текстовой строкой dictinitoption, формат и значение которой различаются в зависимости от шаблона.

Таблица: Столбцы pg_ts_dict

pg_ts_parser

Каталог pg_ts_parser содержит записи, определяющие синтаксические анализаторы текстового поиска. Синтаксический анализатор отвечает за разбиение входного текста на лексемы и присвоение каждой лексеме типа фрагмента. Поскольку синтаксический анализатор должен быть реализован с помощью функций на языке уровня C\RUST, создавать новые синтаксические анализаторы могут только суперпользователи базы данных.

Таблица: Столбцы pg_ts_parser

pg_ts_template

Каталог pg_ts_template содержит записи, определяющие шаблоны текстового поиска. Шаблон — это основа реализации для класса словарей текстового поиска. Поскольку шаблон должен быть реализован с помощью функций на языке уровня C\RUST, создавать новые шаблоны могут только суперпользователи базы данных.

Таблица: Столбцы pg_ts_template

pg_type

В каталоге pg_type хранится информация о типах данных. Базовые типы и типы перечислений (скалярные типы) создаются с помощью команды CREATE TYPE, а домены — с помощью CREATE DOMAIN. Составной тип автоматически создается для каждой таблицы в базе данных для представления структуры строк таблицы. Кроме того, составные типы можно создать с помощью CREATE TYPE AS.

Таблица: Столбцы pg_type

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

В таблице Коды typcategory перечислены определяемые системой значения typcategory. Любые будущие дополнения к этому списку также будут записаны прописными буквами ASCII. Все остальные символы ASCII зарезервированы для пользовательских категорий.

Таблица: Коды typcategory

pg_user_mapping

В каталоге pg_user_mapping хранятся сопоставления локальных пользователей с удаленными. Обычные пользователи не имеют доступа к этому каталогу, вместо этого им следует использовать представление pg_user_mappings.

Таблица: Столбцы pg_user_mapping

Системные представления

Помимо системных каталогов, QHB предоставляет ряд встроенных представлений. Некоторые системные представления обеспечивают удобный доступ к некоторым часто используемым запросам в системных каталогах. Другие представления обеспечивают доступ к внутреннему состоянию сервера.

Информационная схема предоставляет альтернативный набор представлений, которые перекрывают функциональные возможности системных представлений. Поскольку информационная схема является частью стандарта SQL, а описанные здесь представления специфичны для QHB, обычно лучше использовать информационную схему, если та выдает всю необходимую информацию.

В таблице Системные представления перечислены системные представления, описанные в этом разделе. Более подробная документация по каждому представлению приведена ниже. Существуют некоторые дополнительные представления, обеспечивающие доступ к результатам работы сборщика статистических данных; они описаны в таблице Представления по собранной статистике.

Кроме явно отмеченных исключений, все описанные здесь представления доступны только для чтения.

pg_available_extensions

Представление pg_available_extensions содержит список расширений, доступных для установки. См. также каталог pg_extension, в котором отображаются уже установленные расширения.

Таблица: Столбцы pg_available_extensions

Представление pg_available_extensions доступно только для чтения.

pg_available_extension_versions

Представление pg_available_extension_versions содержит список конкретных версий расширений, доступных для установки. См. также каталог pg_extension, в котором отображаются уже установленные расширения.

Таблица: Столбцы pg_available_extension_versions

Представление pg_available_extension_versions доступно только для чтения.

pg_config

Представление pg_config описывает конфигурационные параметры времени компиляции текущей установленной версии QHB. Оно предназначено, например, для использования программными пакетами, которым может понадобиться содействие QHB в поиске необходимых заголовочных файлов и библиотек. Оно выдает ту же основную информацию, что и утилита qhb_config из поставки QHB.

По умолчанию представление pg_config могут прочитать только суперпользователи.

Таблица: Столбцы pg_config

pg_cursors

В представлении pg_cursors перечислены курсоры, доступные в настоящий момент. Курсоры могут быть определены несколькими способами:

• через оператор DECLARE в SQL

• через сообщение Bind в клиент-серверном протоколе QHB

• через интерфейс программирования сервера (SPI, Server Programming Interface), как описано в разделе Функции интерфейса

Представление pg_cursors отображает курсоры, созданные любым из этих средств. Курсоры существуют только в течение транзакции, которая их определяет, если только они не были объявлены WITH HOLD. Таким образом, не удерживаемые курсоры присутствуют в представлении только до конца создавшей их транзакции.

Примечание
Курсоры используются внутри системы для реализации некоторых компонентов QHB, таких как процедурные языки. Поэтому представление pg_cursors может содержать курсоры, которые не были явно созданы пользователем.

Таблица: Столбцы pg_cursors

Представление pg_cursors доступно только для чтения.

pg_file_settings

Представление pg_file_settings выдает сводку содержимого файла(ов) конфигурации сервера. Для каждой записи «имя = значение», имеющейся в этих файлах, данное представление содержит строку с примечаниями, показывающими, может ли это значение быть успешно применено. Также для проблем, не связанных с записью «имя = значение», например синтаксических ошибок в файлах, в этом представлении могут появляться дополнительные строки.

Это представление полезно для проверки того, будут ли работать запланированные изменения в файлах конфигурации, или для диагностики предыдущего сбоя. Обратите внимание, что это представление сообщает о текущем содержимом файлов, а не о том, что было применено сервером в последний раз. (Для получения того состояния обычно достаточно представления pg_settings).

По умолчанию представление pg_file_settings могут прочитать только суперпользователи.

Таблица: Столбцы pg_file_settings

Если файл конфигурации содержит синтаксические ошибки или недопустимые имена параметров, сервер не будет пытаться применить какие-либо параметры из файла, а следовательно, все поля applied будут равны false. В таком случае в представлении будет одна или несколько строк со значением error, отличные от NULL, указывающие на проблему(ы). Иначе, если это возможно, будут применены отдельные параметры. Если отдельный параметр применить нельзя (например, из-за недопустимого значения или если параметр нельзя изменять после запуска сервера), он будет иметь соответствующее сообщение в поле error. Другой вариант, при котором поле applied будет содержать false, означает, что эта запись переопределяется более поздней записью для того же имени параметра; этот случай не считается ошибкой, поэтому в поле error ничего не появляется.

Дополнительную информацию о различных способах изменения параметров времени выполнения см. в разделе Настройка параметров

pg_group

Представление pg_group показывает имена и члены всех ролей, отмеченных как не имеющие признака rolcanlogin, что примерно соответствует набору ролей, которые использовались как группы.

Таблица: Столбцы pg_group

pg_hba_file_rules

Представление pg_hba_file_rules выдает сводку содержимого файла конфигурации аутентификации клиентов, qhb_hba.conf. Для каждой непустой строки файла, не имеющей комментариев, в этом представлении содержится строка с примечаниями, показывающими, может ли это правило быть успешно применено.

Это представление может быть полезно для проверки того, будут ли работать запланированные изменения в файле конфигурации аутентификации, или для диагностики предыдущего сбоя. Обратите внимание, что это представление сообщает о текущем содержимом файла, а не о том, что было загружено сервером в последний раз.

По умолчанию представление pg_hba_file_rules могут прочитать только суперпользователи.

Таблица: Столбцы pg_hba_file_rules

Обычно строка, отражающая неверную запись, будет иметь значения только для полей line_number и error.

pg_indexes

Представление pg_indexes предоставляет доступ к полезной информации о каждом индексе в базе данных.

Таблица: Столбцы pg_indexes

pg_locks

Представление pg_locks предоставляет доступ к информации о блокировках, удерживаемых активными процессами на сервере базы данных. Подробное рассмотрение процесса блокировки см. в главе Управление параллельным доступом.

pg_locks содержит одну строку на каждый активный блокируемый объект, запрошенный режим блокировки и соответствующий процесс. Таким образом, один и тот же блокируемый объект может появляться много раз, если его блокируют или ожидают блокировки несколько процессов. Однако объект, который в настоящее время не имеет блокировок, не будет отображаться вообще.

Существует несколько различных типов блокируемых объектов: отношения целиком (например, таблицы), отдельные страницы отношений, отдельные кортежи отношений, идентификаторы транзакций (как виртуальные, так и постоянные) и общие объекты базы данных (идентифицируемые по OID класса и OID объекта, так же как и в pg_description или pg_depend). Также в виде отдельного блокируемого объекта представляется право на расширение отношения, как и право изменения значения pg_database.datfrozenxid. Кроме того, «необязательные» блокировки могут иметь номера, значения которых определяет пользователь.

Таблица: Столбцы pg_locks

Поле granted имеет значение true в строке, представляющей блокировку, удерживаемую указанным процессом. Значение false показывает, что этот процесс в настоящее время ожидает получения данной блокировки, свидетельствуя о том, что как минимум еще один процесс удерживает или ожидает блокировку того же объекта в конфликтном режиме. Процесс ожидания будет находиться в спящем режиме до тех пор, пока не будет снята другая блокировка (или обнаружена ситуация взаимоблокировки). Один процесс может ожидать получения не более одной блокировки за один раз.

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

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

Необязательные блокировки можно получить по ключам, состоящим из одного значения bigint или двух значений integer. При выведении ключа bigint его старшая часть отображается в столбце classid, младшая — в столбце objid, а objsubid равен 1. Исходное значение bigint можно собрать заново с помощью выражения (classid::bigint << 32) | objid::bigint. Ключи integer отображаются так: первый в столбце classid, второй — в столбце objid, а objsubid равен 2. Фактическое значение ключей определяет пользователь. Необязательные блокировки являются локальными для каждой базы данных, поэтому столбец database имеет для них значение.

pg_locks обеспечивает глобальное представление всех блокировок в кластере баз данных, а не только тех, которые относятся к текущей базе данных. Хотя через соединение столбцов relation и pg_class.oid можно определить заблокированные отношения, это будет правильно работать только для отношений в текущей базе данных (т. е. тех, для которых столбец database — это либо OID текущей базы данных, либо ноль).

Столбец pid можно соединить со столбцом pid представления pg_stat_activity, что позволит получить дополнительную информацию о сеансе, удерживающем или ожидающем каждую блокировку, например

SELECT * FROM pg_locks pl LEFT JOIN pg_stat_activity psa
    ON pl.pid = psa.pid;

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

SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
    ON pl.virtualtransaction = '-1/' || ppx.transaction;

Хотя и возможно получить информацию о том, какие из процессов блокируют другие процессы (и какие именно), соединив представление pg_locks с самим собой, крайне трудно сделать это правильно во всех деталях. Такому запросу пришлось бы кодировать знания о том, какие режимы блокировки конфликтуют с другими. Хуже того, представление pg_locks не выдает информацию ни о том, какие процессы опережают другие в очереди ожидания блокировки, ни о том, какие процессы являются параллельными рабочими процессами и от от имени каких других сеансов клиента они выполняются. Чтобы определить, каким процессом (или процессами) блокируется ожидающий процесс, лучше воспользоваться функцией pg_blocking_pids() (см. таблицу Информационные функции сеанса).

Представление pg_locks отображает данные как из диспетчера обычных блокировок, так и из диспетчера предикатных блокировок, которые являются отдельными системами; кроме того, диспетчер обычных блокировок подразделяет свои блокировки на обычные и полученные быстрым путем. Полная согласованность этих данных не гарантируется. При запросе к этому представлению данные о блокировках по быстрому пути (с fastpath = true) собираются с каждого серверного процесса по очереди, без замораживания состояние всего диспетчера блокировок, поэтому существует вероятность того, что во время сбора этой информации блокировки будут получены или освобождены. Обратите внимание, однако, что эти блокировки, как известно, не должны конфликтовать ни с какими другими действующими блокировками. После того, как во все серверные процессы были сделаны запросы для получения быстрых блокировок, оставшаяся часть диспетчера обычных блокировок блокируется как единое целое, и согласованный снимок всех оставшихся блокировок собирается атомарно. После разблокирования диспетчера обычных блокировок аналогичным образом блокируется диспетчер предикатных блокировок, и все предикатные блокировки собираются атомарно. Таким образом, за исключением быстрых блокировок, каждый диспетчер блокировок будет выдавать согласованный набор результатов, но поскольку мы не блокируем оба диспетчера блокировок одновременно, блокировки могут быть получены или освобождены после опроса диспетчера обычных блокировок и до опроса диспетчера предикатных блокировки.

Блокировка диспетчера обычных и/или предикатных блокировок может некоторым образом повлиять на производительность базы данных, если очень часто обращаться к этому представлению. Эти блокировки удерживаются не дольше, чем необходимо для получения данных от диспетчеров блокировок, но это не до конца исключает возможность влияния на производительность.

pg_matviews

Представление pg_matviews обеспечивает доступ к полезной информации о каждом материализованном представлении в базе данных.

Таблица: Столбцы pg_matviews

pg_policies

Представление pg_policies обеспечивает доступ к полезной информации о каждой политике защиты на уровне строк в базе данных.

Таблица: Столбцы pg_policies

pg_prepared_statements

В представлении pg_prepared_statements отображаются все подготовленные операторы, доступные в текущем сеансе. Более подробную информацию о подготовленных операторах см. в описании команды PREPARE.

pg_prepared_statements содержит отдельную строку для каждого подготовленного оператора. Строки добавляются в представление при создании нового подготовленного оператора и удаляются при освобождении подготовленного оператора (например, с помощью команды DEALLOCATE).

Таблица: Столбцы pg_prepared_statements

Представление pg_prepared_statements доступно только для чтения.

pg_prepared_xacts

В представлении pg_prepared_xacts отображается информация о транзакциях, которые в настоящее время подготовлены для двухфазной фиксации (подробную информацию см. в описании команды PREPARE TRANSACTION).

pg_prepared_xacts содержит отдельную строку для каждой подготовленной транзакции. Запись удаляется при фиксации или откате транзакции.

Таблица: Столбцы pg_prepared_xacts

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

pg_publication_tables

Представление pg_publication_tables выдает информацию о сопоставлении публикаций и таблиц, которые они содержат. В отличие от нижележащего каталога pg_publication_rel, это представление расширяет список публикаций, определенных как FOR ALL TABLES, поэтому для таких публикаций будет наличествовать строка для каждой соответствующей таблицы.

Таблица: Столбцы pg_publication_tables

pg_replication_origin_status

В представлении pg_replication_origin_status содержится информация о прогрессе воспроизведения записей репликации, достигнутом для определенного источника.

Таблица: Столбцы pg_replication_origin_status

pg_replication_slots

Представление pg_replication_slots выдает список всех слотов репликации, которые в настоящее время существуют в кластере баз данных, а также их текущее состояние.

Таблица: Столбцы pg_replication_slots

pg_roles

Представление pg_roles обеспечивает доступ к информации о ролях базы данных. Это просто доступное для всех представление pg_authid, которое скрывает поле пароля.

Таблица: Столбцы pg_roles

pg_rules

Представление pg_rules обеспечивает доступ к полезной информации о правилах перезаписи запросов.

Таблица: Столбцы pg_rules

Из представления pg_rules исключены правила ON SELECT для представлений и материализованных представлений; их можно увидеть в pg_views и pg_matviews.

pg_seclabels

Представление pg_seclabels предоставляет информацию о метках безопасности. Это более простая для обращения версия каталога pg_seclabel.

Таблица: Столбцы pg_seclabels

pg_sequences

Представление pg_sequences обеспечивает доступ к полезной информации о каждой последовательности в базе данных.

Таблица: Столбцы pg_sequences

pg_settings

Представление pg_setting обеспечивает доступ к параметрам времени выполнения сервера. В сущности это альтернативный интерфейс к командам SHOW и SET. Также оно обеспечивает доступ к некоторым фактам о каждом параметре, которые нельзя получить напрямую при помощи команды SHOW, например, минимальные и максимальные значения.

Таблица: Столбцы pg_settings

Существует несколько возможных значений контекста. В порядке уменьшения сложности изменения параметров, ими являются:

internal

Эти параметры нельзя изменить непосредственно; они отражают значения, определенные внутри системы. Некоторые из них можно изменить, пересобрав сервер с другими параметрами конфигурации, или изменив параметры, передаваемые в qhb_bootstrap.

postmaster

Эти параметры можно применять только при запуске сервера, поэтому любое изменение требует его перезагрузки. Значения для этих параметров обычно хранятся в файле qhb.conf либо передаются в командной строке при запуске сервера. Разумеется, параметры любого из нижеследующих типов context также можно задать во время запуска сервера.

sighup

Изменения этих параметров можно вносить в qhb.conf без перезагрузки сервера. Если послать в qhbmaster (управляющий процесс) сигнал SIGHUP, он перечитает qhb.conf и применит изменения. Qhbmaster также перешлет сигнал SIGHUP своим дочерним процессам, чтобы все они приняли новое значение.

superuser-backend

Изменения этих параметров можно вносить в qhb.conf без перезагрузки сервера. Они также могут быть установлены для определенного сеанса в пакете запроса на подключение (например, через переменную окружения PGOPTIONS), но только если подключающийся пользователь является суперпользователем. Однако эти параметры никогда не изменяются в сеансе после его запуска. Если вы измените их внутри qhb.conf, отправьте сигнал SIGHUP в qhbmaster, чтобы тот перечитал qhb.conf. Новые значения будут влиять только на сеансы, запускаемые впоследствии.

backend

Изменения этих параметров можно вносить в qhb.conf без перезагрузки сервера. Они также могут быть установлены для определенного сеанса в пакете запроса на подключение (например, через переменную окружения PGOPTIONS); любой пользователь может внести такое изменение для своей сессии. Однако эти параметры никогда не изменяются в сеансе после его запуска. Если вы измените их внутри qhb.conf, отправьте сигнал SIGHUP в qhbmaster, чтобы тот перечитал qhb.conf. Новые значения будут влиять только на сеансы, запускаемые впоследствии.

superuser

Эти параметры можно задать из qhb.conf или в рамках сеанса с помощью команды SET, но только суперпользователи могут изменить их посредством SET. Изменения в qhb.conf будут влиять на существующие сеансы только в том случае, если в них командой SET не были заданы локальные в рамках сеанса значения.

user

Эти параметры можно задать из qhb.conf или в рамках сеанса с помощью команды SET. В рамках сеанса их локальное значение может изменить любой пользователь. Изменения в qhb.conf будут влиять на существующие сеансы только в том случае, если в них командой SET не были заданы локальные в рамках сеанса значения.

Более подробную информацию о различных способах изменения этих параметров см. в разделе Настройка параметров.

Представление pg_settings нельзя вставить или удалить, но его можно изменить. Команда UPDATE, примененная к pg_settings, равнозначна выполнению команды SET для этого конкретного параметра. Это изменение влияет только на значение, используемое в текущем сеансе. Если команда UPDATE выполняется в рамках транзакции, которая затем прерывается, эффекты UPDATE пропадают при откате транзакции. После фиксации окружающей транзакции эти эффекты сохранятся до конца сеанса, если только не будут переопределены другой командой UPDATE или SET.

pg_shadow

В представлении pg_shadow показаны свойства всех ролей, которые помечены как rolcanlogin в pg_authid.

Такое имя («тень») обусловлено тем фактом, что эта таблица не должна быть доступна для чтения любому пользователю, поскольку она содержит пароли. pg_user — это доступное всем представление для pg_shadow, в котором стерто поле пароля.

Таблица: Столбцы pg_shadow

pg_stats

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

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

Таблица: Столбцы pg_stats

Максимальным числом записей в полях массива можно управлять на уровне столбцов с помощью команды ALTER TABLE SET STATISTICS или глобально, задавая параметр времени выполнения default_statistics_target.

pg_stats_ext

Представление pg_stats_ext обеспечивает доступ к информации, хранящейся в каталогах pg_statistic_ext и pg_statistic_ext_data. Это представление дает доступ только к тем строкам pg_statistic_ext и pg_statistic_ext_data, которые соответствуют таблицам, которые пользователь может читать; таким образом, можно без опасений разрешить публичный доступ на чтение к этому представлению.

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

Таблица: Столбцы pg_stats_ext

Максимальным числом записей в полях массива можно управлять на уровне столбцов с помощью команды ALTER TABLE SET STATISTICS или глобально, задав параметр времени выполнения default_statistics_target.

pg_tables

Представление pg_tables обеспечивает доступ к полезной информации о каждой таблице в базе данных.

Таблица: Столбцы pg_tables

pg_timezone_abbrevs

Представление pg_timezone_abbrevs содержит список сокращений часовых поясов, которые в настоящее время верно распознаются функциями ввода даты/времени. Содержание этого представления изменяется при изменении параметра времени выполнения timezone_abbreviations.

Таблица: Столбцы pg_timezone_abbrevs

Хотя большинство сокращений часовых поясов представляют собой фиксированные смещения от UTC, в некоторых поясах значение смещения менялось в ходе истории. В таких случаях это представление содержит их текущее значение.

pg_timezone_names

Представление pg_timezone_names содержит список имен часовых поясов, которые распознаются командой SET TIMEZONE, а также связанные с ними сокращения, смещения UTC и статус летнего времени. (Технически QHB не использует UTC, потому что високосные секунды не обрабатываются). В отличие от сокращений, показанных в pg_timezone_abbrevs, многие из этих имен подразумевают набор правил перехода на летнее время. Поэтому связанная информация изменяется при пересечении локальных границ перехода на летнее время. Отображаемая информация вычисляется на основе текущего значения параметра CURRENT_TIMESTAMP.

Таблица: Столбцы pg_timezone_names

pg_user

Представление pg_user обеспечивает доступ к информации о пользователях базы данных. Это просто общедоступное представление каталога pg_shadow, в котором скрыто поле пароля.

Таблица: Столбцы pg_user

pg_user_mappings

Представление pg_user_mappings обеспечивает доступ к информации о сопоставлениях пользователей. По сути это общедоступное представление каталога pg_user_mapping, которое не показывает поле параметров, если у пользователя нет прав на его использование.

Таблица: Столбцы pg_user_mappings

Чтобы защитить информацию о пароле, сохраненную в качестве параметра сопоставления пользователей, столбец umoptions будет считываться как NULL, если не применяется одно из следующих условий:

• текущий пользователь является сопоставляемым пользователем, который владеет сервером или имеет для него право USAGE

• текущий пользователь является владельцем сервера и прочитывается сопоставление для PUBLIC

• текущий пользователь является суперпользователем

pg_views

Представление pg_views обеспечивает доступ к полезной информации о каждом представлении в базе данных.

Таблица: Столбцы pg_views