9.27. Системные информационные функции и операторы #
- 9.27.1. Функции получения информации о сеансе
- 9.27.2. Функции для проверки прав доступа
- 9.27.3. Функции для определения видимости
- 9.27.4. Функции для обращения к системным каталогам
- 9.27.5. Функции получения информации и адресации объектов
- 9.27.6. Функции получения комментариев
- 9.27.7. Функции проверки допустимости данных
- 9.27.8. Функции получения информации об идентификаторах транзакций и снимках состояния
- 9.27.9. Функции получения информации о фиксации транзакций
- 9.27.10. Функции управления данными
- 9.27.11. Функции получения информации о версии
- 9.27.12. Функции получения информации о сводках WAL
- 9.27.2. Функции для проверки прав доступа
Функции, описанные в этом разделе, предназначены для получения различной информации о сервере Postgres Pro.
9.27.1. Функции получения информации о сеансе #
В Таблице 9.69 перечислен ряд функций, предназначенных для получения информации о текущем сеансе и системе.
В дополнение к перечисленным здесь функциям существуют также функции, связанные с подсистемой статистики, которые тоже предоставляют системную информацию. Подробнее они рассматриваются в Подразделе 26.2.2.
Таблица 9.69. Функции получения информации о сеансе
Функция Описание |
---|
Выдаёт имя текущей базы данных. (В стандарте SQL базы данных называются «каталогами», поэтому стандарту соответствует написание |
Выдаёт текст запроса, выполняемого в данный момент, в том виде, в каком его передал клиент (может состоять из нескольких операторов). |
Аналог |
Выдаёт имя первой схемы в пути поиска (или значение NULL, если путь поиска пустой). В эту схему будут добавляться таблицы и другие объекты, при создании которых схема не указывается явно. |
Выдаёт массив имён всех схем, в настоящее время представленных в действующем пути поиска, по порядку их приоритета. (Элементы текущего значения search_path, которым не соответствуют существующие схемы, опускаются). Если логический аргумент равен |
Выдаёт имя пользователя в текущем контексте выполнения. |
Выдаёт IP-адрес текущего клиента либо |
Выдаёт номер TCP-порта текущего клиента либо |
Выдаёт IP-адрес, через который сервер принял текущее подключение, либо NULL, если текущее подключение установлено через Unix-сокет. |
Выдаёт номер TCP-порта, через который сервер принял текущее подключение, либо |
Выдаёт идентификатор серверного процесса, обслуживающего текущий сеанс. |
Выдаёт массив с идентификаторами процессов сеансов, которые блокируют серверный процесс с указанным идентификатором, либо пустой массив, если указанный серверный процесс не найден или не заблокирован. Один серверный процесс блокирует другой, если он либо удерживает блокировку, конфликтующую с блокировкой, запрашиваемой вторым (жёсткая блокировка), либо ожидает блокировку, которая вызвала бы конфликт с запросом блокировки заблокированного процесса и находится перед ней в очереди ожидания (мягкая блокировка). При распараллеливании запросов эта функция всегда выдаёт видимые клиентом идентификаторы процессов (то есть, результаты Частые вызовы этой функции могут отразиться на производительности базы данных, так как ей нужен монопольный доступ к общему состоянию менеджера блокировок, пусть и на короткое время. |
Выдаёт время, когда в последний раз сервер загружал файлы конфигурации. (Если текущий сеанс начался раньше, она возвращает время, когда эти файлы были перезагружены для данного сеанса, так что в разных сеансах это значение может немного различаться. В противном случае это будет время, когда файлы конфигурации считал главный процесс.) |
Выдаёт путь к файлу журнала, в настоящее время используемому сборщиком сообщений. Этот путь состоит из пути каталога log_directory и имени конкретного файла. Если сборщик сообщений отключён, выдаётся значение По умолчанию доступ к этой функции имеют только суперпользователи или роли с правами роли |
Выдаёт OID временной схемы текущего сеанса или 0, если такой схемы нет (в рамках сеанса не создавались временные таблицы). |
Выдаёт true, если заданный OID относится к временной схеме другого сеанса. (Это может быть полезно, например для исключения временных таблиц других сеансов из общего списка при просмотре таблиц базы данных.) |
Выдаёт true, если в данном сеансе доступна JIT-компиляция (см. Главу 29) и параметр конфигурации jit включён. |
Выдаёт список имён каналов асинхронных уведомлений, по которым текущий сеанс принимает сигналы. |
Выдаёт долю (0–1) максимального размера очереди асинхронных уведомлений, в настоящее время занятую уведомлениями, ожидающими обработки. За дополнительными сведениями обратитесь к LISTEN и NOTIFY. |
Выдаёт время, когда был запущен сервер. |
Выдаёт массив с идентификаторами процессов сеансов, которые блокируют серверный процесс с указанным идентификатором, не давая ему получить безопасный снимок, либо выдаёт пустой массив, если такой серверный процесс не найден или он не заблокирован. Сеанс, выполняющий транзакцию уровня Частые вызовы этой функции могут отразиться на производительности сервера, так как ей нужен доступ к общему состоянию менеджера предикатных блокировок, пусть и на короткое время. |
Выдаёт текущий уровень вложенности в триггерах Postgres Pro (0, если эта функция вызывается не из тела триггера, непосредственно или косвенно). |
Выдаёт имя пользователя сеанса. |
Возвращает метод аутентификации и идентификационную информацию (если есть), которые пользователь представил во время цикла аутентификации до того, как ему была назначена роль базы данных. Он представлен как |
Аналог |
Примечание
Функции current_catalog
, current_role
, current_schema
, current_user
, session_user
и user
имеют особый синтаксический статус в SQL: они должны вызываться без скобок после имени. Postgres Pro позволяет добавить скобки в вызове current_schema
, но не других функций.
Функция session_user
обычно возвращает имя пользователя, установившего текущее соединение с базой данных, но суперпользователи могут изменить это имя, выполнив команду SET SESSION AUTHORIZATION. Функция current_user
возвращает идентификатор пользователя, по которому будут проверяться его права. Обычно это тот же пользователь, что и пользователь сеанса, но его можно сменить с помощью SET ROLE. Этот идентификатор также меняется при выполнении функций с атрибутом SECURITY DEFINER
. На языке Unix пользователь сеанса называется «реальным», а текущий — «эффективным». Имена current_role
и user
являются синонимами current_user
. (В стандарте SQL current_role
и current_user
имеют разное значение, но в Postgres Pro они не различаются, так как пользователи и роли объединены в единую сущность.)
9.27.2. Функции для проверки прав доступа #
В Таблице 9.70 показаны функции, позволяющие программно проверить права доступа к объектам. (Подробнее о правах рассказывается в Разделе 5.8.) Этим функциям в качестве идентификатора пользователя, для которого запрашиваются права, можно передать его имя или OID (pg_authid
.oid
), а также можно передать public
(это будет указывать на псевдороль PUBLIC). Кроме того, аргумент user
можно полностью опустить, тогда будет подразумеваться current_user
. Объект, права для доступа к которому запрашиваются, также можно задать по имени или по OID. Когда указывается имя объекта, его можно дополнить именем схемы, если это уместно. Запрашиваемое право записывается текстовой строкой, которая должна задавать одно из прав доступа, соответствующих типу объекта (например, SELECT
). Дополнительно к названию права можно добавить WITH GRANT OPTION
и проверить, разрешено ли пользователю передавать это право другим. Кроме того, в одном параметре можно перечислить несколько прав через запятую, и тогда функция возвратит true
, если пользователь имеет какие-либо из них. (Регистр в названии прав не имеет значения, а между ними (но не внутри) разрешены пробельные символы.) Пара примеров:
SELECT has_table_privilege('myschema.mytable', 'select'); SELECT has_table_privilege('joe', 'mytable', 'INSERT, SELECT WITH GRANT OPTION');
Таблица 9.70. Функции для проверки прав доступа
Функция Описание |
---|
Имеет ли пользователь указанное право для какого-либо столбца таблицы? Ответ положительный, когда он имеет это право для всей таблицы или ему дано соответствующее право на уровне столбцов хотя бы для одного столбца. Возможные права: |
Имеет ли пользователь указанное право для заданного столбца таблицы? Ответ положительный, когда он имеет это право для всей таблицы или ему дано соответствующее право на уровне столбца. Столбец можно задать по имени или номеру атрибута ( |
Имеет ли пользователь указанное право в базе данных? Возможные права: |
Имеет ли пользователь право для обёртки сторонних данных? На данный момент возможно только одно право: |
Имеет ли пользователь право для функции? Возможно единственное право: При указании функции по имени, а не по OID, допускаются те же входные значения, что и для типа SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute'); |
Имеет ли пользователь право для языка? Возможно единственное право: |
Имеет ли пользователь право для параметра конфигурации? Регистр в имени параметра игнорируется. Возможные права: |
Имеет ли пользователь право для схемы? Возможные права: |
Имеет ли пользователь право для последовательности? Возможные права: |
Имеет ли пользователь право для стороннего сервера? На данный момент возможно только одно право: |
Имеет ли пользователь право для таблицы? Возможные права: |
Имеет ли пользователь право для табличного пространства? Возможно единственное право: |
Имеет ли пользователь право для типа данных? Возможно единственное право: |
Имеет ли пользователь право для роли? Возможные права: |
Действует ли защита на уровне строк для заданной таблицы в контексте текущего пользователя в текущем окружении? |
В Таблице 9.71 показаны операторы, предназначенные для работы с типом aclitem
, который представляет в системном каталоге права доступа. О содержании значений этого типа рассказывается в Разделе 5.8.
Таблица 9.71. Операторы для типа aclitem
В Таблице 9.72 приведены дополнительные функции, предназначенные для работы с типом aclitem
.
Таблица 9.72. Функции для типа aclitem
Функция Описание |
---|
Выдаёт массив с элементами |
Возвращает массив |
Конструирует значение |
9.27.3. Функции для определения видимости #
В Таблице 9.73 показаны функции, определяющие видимость объекта с текущим путём поиска схем. К примеру, таблица считается видимой, если содержащая её схема включена в путь поиска и нет другой таблицы с тем же именем, которая была бы найдена в этом пути раньше. Другими словами, к этой таблице можно будет обратиться просто по её имени, без явного указания схемы. Просмотреть список всех видимых таблиц можно так:
SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);
Объект, представляющий функцию и оператор, считаются видимым в пути поиска, если при просмотре пути не находится предшествующий ему другой объект с тем же именем и типами аргументов. Для семейств и классов операторов помимо имени объекта во внимание принимается также связанный метод доступа к индексу.
Таблица 9.73. Функции для определения видимости
Всем этим функциям должен передаваться OID проверяемого объекта. Если вы хотите проверить объект по имени, удобнее использовать типы-псевдонимы OID (regclass
, regtype
, regprocedure
, regoperator
, regconfig
или regdictionary
), например:
SELECT pg_type_is_visible('myschema.widget'::regtype);
Заметьте, что проверять таким способом имена без указания схемы не имеет большого смысла — если имя удастся распознать, значит и объект будет видимым.
9.27.4. Функции для обращения к системным каталогам #
В Таблице 9.74 перечислены функции, извлекающие информацию из системных каталогов.
Таблица 9.74. Функции для обращения к системным каталогам
Функция Описание |
---|
Выдаёт в формате SQL имя типа данных, определяемого по OID и, возможно, модификатору типа. Если модификатор неизвестен, вместо него можно передать NULL. |
Возвращает OID базового типа домена, идентифицируемого его OID типа. Если в аргументе передаётся OID недоменного типа, он возвращается как есть. Возвращает NULL, если аргумент не является допустимым OID типа. Если есть цепочка доменных зависимостей, функция будет рекурсивно выполняться до тех пор, пока не будет найден базовый тип. Предположим, для
|
Преобразует предоставленное имя кодировки в целое число, представляющее внутренний идентификатор, используемый в некоторых таблицах системного каталога. Возвращает |
Преобразует целое число, используемое в качестве внутреннего идентификатора кодировки в некоторых таблицах системного каталога, в понятное имя. Возвращает пустую строку, если указан неправильный номер кодировки. |
Возвращает набор записей, описывающих отношения внешних ключей, существующие в системных каталогах Postgres Pro. Столбец |
Восстанавливает команду, создающую ограничение. (Текст команды не является изначальным, он восстанавливается путём декомпиляции.) |
Декомпилирует внутреннюю форму выражений, находящихся в системных каталогах, например, выражений, задающих значения по умолчанию. Если выражение может содержать Vars (переменные), передайте во втором параметре OID отношения, к которому обращается данное выражение; в противном случае достаточно передать 0. |
Восстанавливает команду, создающую функцию или процедуру. (Текст команды не является изначальным, он восстанавливается путём декомпиляции.) В результате выдаётся полноценный оператор |
Восстанавливает список аргументов для функции или процедуры в том виде, в каком он должен задаваться в команде |
Восстанавливает список аргументов, необходимый для однозначной идентификации функции или процедуры, в том виде, в каком он должен задаваться, например в |
Восстанавливает для функции предложение |
Восстанавливает команду, создающую индекс. (Текст команды не является изначальным, он восстанавливается путём декомпиляции.) Если передаётся значение |
Выдаёт набор записей, описывающих ключевые слова, которые воспринимает сервер. Столбец |
Восстанавливает определение ключа секционирования секционированной таблицы в той форме, которую он имел бы в предложении |
Восстанавливает команду, создающую правило. (Текст команды не является изначальным, он восстанавливается путём декомпиляции.) |
Выдаёт имя последовательности, связанной со столбцом, либо NULL, если такой последовательности нет. Для столбца идентификации это будет последовательность, созданная для него неявно внутри. Для столбцов, имеющих один из последовательных типов ( Обычно эта функция применяется для получения текущего значения последовательности для столбца идентификации или последовательного столбца, например так: SELECT currval(pg_get_serial_sequence('sometable', 'id')); |
Восстанавливает команду, создающую объект расширенной статистики. (Текст команды не является изначальным, он восстанавливается путём декомпиляции.) |
Восстанавливает команду, создающую триггер. (Текст команды не является изначальным, он восстанавливается путём декомпиляции.) |
Выдаёт имя роли по заданному OID. |
Восстанавливает команду |
Восстанавливает команду |
Восстанавливает команду |
Проверяет, имеет ли столбец индекса заданное свойство. Типичные свойства столбцов описаны в Таблице 9.75. (Заметьте, что расширенные методы доступа могут определять для своих индексов дополнительные свойства.) Если заданное имя свойства не известно или не применимо к конкретному объекту, либо если OID или номер столбца не указывают на существующий объект, эта функция возвращает |
Проверяет, имеет ли индекс заданное свойство. Типичные свойства индексов описаны в Таблице 9.75. (Заметьте, что расширенные методы доступа могут определять для своих индексов дополнительные свойства.) Если заданное имя свойства не известно или не применимо к конкретному объекту, либо если OID не указывает на существующий объект, эта функция возвращает |
Проверяет, имеет ли метод доступа индекса заданное свойство. Свойства методов доступа описаны в Таблице 9.77. Если заданное имя свойства неизвестно или не применимо к конкретному объекту, либо если OID не указывает на существующий объект, эта функция возвращает |
Выдаёт набор параметров хранилища, представленных значением из |
Возвращает массив флагов, связанных с данным параметром GUC, или |
Выдаёт набор OID баз данных, объекты которых размещены в заданном табличном пространстве. Если эта функция возвращает строки, это означает, что табличное пространство не пустое и удалить его нельзя. Какие именно объекты находятся в табличном пространстве, можно определить, подключаясь к базам данных, OID которых сообщила |
Выдаёт путь в файловой системе к местоположению заданного табличного пространства. |
Выдаёт OID типа данных для переданного значения. Это может быть полезно для разрешения проблем или динамического создания SQL-запросов. Эта функция объявлена как возвращающая тип
|
Выдаёт имя правила сортировки для переданного значения. Это значение может быть заключено в кавычки и дополнено схемой. Если с выражением аргумента не связано правило сортировки, возвращается
|
Переводит в OID текстовое имя отношения. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя правила сортировки. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя схемы. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя оператора. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя оператора с указанием типов параметров. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя функции или процедуры. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя функции или процедуры с указанием типов аргументов. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя профиля. Подобный результат можно получить, приведя строку с именем к типу |
Переводит в OID текстовое имя роли. Подобный результат можно получить, приведя строку с именем к типу |
Анализирует строку текста, извлекает из неё потенциальное имя типа и переводит это имя в OID типа. Синтаксическая ошибка в строке приведёт к ошибке, но если строка является синтаксически допустимым именем типа, которое не найдено в каталогах, результатом будет |
Разбирает строку текста, извлекает из неё потенциальное имя типа и переводит модификатор типа при его наличии. Синтаксическая ошибка в строке приведёт к ошибке, но если строка является синтаксически допустимым именем типа, которое не найдено в каталогах, результатом будет Функцию
|
Многие из функций, восстанавливающих (декомпилирующих) объекты БД, принимают дополнительный флаг pretty
, в котором можно передать true
для визуального улучшения вывода. При этом будут убраны лишние скобки и добавлены пробельные символы, чтобы текст был более разборчивым. Преобразованный вывод легче читается, но формат по умолчанию с большей вероятностью будет успешно восприниматься будущими версиями Postgres Pro, поэтому для выгрузки содержимого БД рекомендуется избегать использования визуально улучшенного формата. Если параметр pretty
равен false
, это равнозначно его отсутствию.
Таблица 9.75. Свойства столбца индекса
Имя | Описание |
---|---|
asc | Сортируется ли столбец по возрастанию при сканировании вперёд? |
desc | Сортируется ли столбец по убыванию при сканировании вперёд? |
nulls_first | Выдаются ли NULL в начале при сканирования вперёд? |
nulls_last | Выдаются ли NULL в конце при сканировании вперёд? |
orderable | Связан ли со столбцом некоторый порядок сортировки? |
distance_orderable | Может ли столбец сканироваться по порядку оператором «расстояния», например, ORDER BY столбец <-> константа ? |
returnable | Может ли значение столбца быть получено при сканировании только индекса? |
search_array | Поддерживает ли столбец внутренними средствами поиск столбец = ANY(массив) ? |
search_nulls | Поддерживает ли столбец поиск IS NULL и IS NOT NULL ? |
Таблица 9.76. Свойства индекса
Имя | Описание |
---|---|
clusterable | Может ли индекс использоваться в команде CLUSTER ? |
index_scan | Поддерживает ли индекс простое сканирование (не по битовой карте)? |
bitmap_scan | Поддерживает ли индекс сканирование по битовой карте? |
backward_scan | Может ли в процессе сканирования меняться направление (для поддержки перемещения курсора FETCH BACKWARD без необходимости материализации)? |
Таблица 9.77. Свойства метода доступа индекса
Имя | Описание |
---|---|
can_order | Поддерживает ли метод доступа ASC , DESC и связанные ключевые слова в CREATE INDEX ? |
can_unique | Поддерживает ли метод доступа уникальные индексы? |
can_multi_col | Поддерживает ли метод доступа индексы по нескольким столбцам? |
can_exclude | Поддерживает ли метод доступа ограничения-исключения? |
can_include | Поддерживает ли метод доступа предложение INCLUDE команды CREATE INDEX ? |
Таблица 9.78. Флаги параметров GUC
Флаг | Описание |
---|---|
EXPLAIN | Параметры с этим флагом включаются в команды EXPLAIN (SETTINGS) . |
NO_SHOW_ALL | Параметры с этим флагом исключаются из команд SHOW ALL . |
NO_RESET | Параметры с этим флагом не поддерживают команды RESET . |
NO_RESET_ALL | Параметры с этим флагом исключаются из команд RESET ALL . |
NOT_IN_SAMPLE | Параметры с этим флагом не включаются в postgresql.conf по умолчанию. |
RUNTIME_COMPUTED | Параметры с этим флагом вычисляются во время выполнения. |
9.27.5. Функции получения информации и адресации объектов #
В Таблице 9.79 перечислены функции, связанные с идентификацией и адресацией объектов баз данных.
Таблица 9.79. Функции получения информации и адресации объектов
9.27.6. Функции получения комментариев #
Функции, перечисленные в Таблице 9.80, извлекают комментарии, заданные для объектов с помощью команды COMMENT. Если найти комментарий для заданных параметров не удаётся, они возвращают NULL.
Таблица 9.80. Функции получения комментариев
9.27.7. Функции проверки допустимости данных #
Функции, показанные в Таблица 9.81, могут быть полезны для проверки допустимости предлагаемых входных данных.
Таблица 9.81. Функции проверки допустимости данных
9.27.8. Функции получения информации об идентификаторах транзакций и снимках состояния #
Функции, показанные в Таблице 9.82, выдают информацию о транзакциях сервера в виде, подходящем для экспорта. В основном эти функции используются, чтобы определить, какие транзакции были зафиксированы между двумя снимками состояния.
Таблица 9.82. Функции получения информации об идентификаторах транзакций и снимках состояния
Функция Описание |
---|
Выдаёт идентификатор текущей транзакции. Если у текущей транзакции ещё нет идентификатора (она не успела выполнить какие-либо изменения в базе), он будет ей назначен; подробнее см. Раздел 64.1. Если выполняется в подтранзакции, выдаёт идентификатор транзакции верхнего уровня; подробнее см. Раздел 64.3. |
Выдаёт идентификатор текущей транзакции или |
Выдаёт состояние фиксации транзакции. Результатом будет одно из значений: |
Возвращает текущий снимок состояния — структуру данных, показывающую идентификаторы транзакций, которые выполняются в момент снимка. В снимок включаются только идентификаторы транзакций верхнего уровня; идентификаторы подтранзакций не отображаются; за подробностями обратитесь к Разделу 64.3. |
Выдаёт набор идентификаторов выполняющихся транзакций, содержащихся в снимке. |
Выдаёт значение |
Выдаёт |
Видна ли транзакция с указанным идентификатором в данном снимке (то есть, была ли она завершена до момента получения снимка)? Обратите внимание, что эта функция не выдаст правильный ответ, если ей передать идентификатор подтранзакции (subxid); за подробностями обратитесь к Разделу 64.3. |
Внутренний тип идентификаторов транзакций, xid
, имеет размер 32 бита и значения в нём повторяются через каждые 4 миллиарда транзакций. Однако функции, показанные в Таблице 9.82 используют 64-битный тип xid8
, значения которого не повторяются на протяжении всей жизни сервера и могут быть приведены к типу xid
, если требуется (подробное описание находится в Разделе 64.1). Тип данных pg_snapshot
содержит информацию о видимости транзакций в определённый момент времени. Его компоненты описаны в Таблице 9.83. В текстовом виде pg_snapshot
представляется как
. Например, запись xmin
:xmax
:список_xip
10:20:10,14,15
обозначает xmin=10, xmax=20, xip_list=10, 14, 15
.
Таблица 9.83. Состав информации о снимке
Имя | Описание |
---|---|
xmin | Минимальный идентификатор транзакции среди всех активных. Все транзакции, идентификаторы которых меньше xmin , уже либо зафиксированы и видимы, либо отменены и «мертвы». |
xmax | Идентификатор на один больше идентификатора последней завершённой транзакции. Все транзакции, идентификаторы которых больше или равны xmax , на момент получения снимка ещё не завершены и не являются видимыми. |
xip_list | Транзакции, выполняющиеся в момент получения снимка. Транзакции с такими идентификаторами, для которых xmin <= , не попавшие в этот список, были уже завершены на момент получения снимка, и поэтому либо видимы, либо «мертвы», в зависимости от варианта завершения. Идентификаторы подтранзакций (subxid) в этот список не включаются. |
До 13 версии в Postgres Pro отсутствовал тип xid8
, поэтому предлагались вариации этих функций, в которых 64-битные XID представлялись в типе bigint
, а для информации о снимке использовался отдельный тип txid_snapshot
. В названиях этих старых функций фигурирует txid
. Они по-прежнему поддерживаются для обратной совместимости, но могут быть удалены в будущем. См. Таблицу 9.84.
Таблица 9.84. Устаревшие функции получения информации об идентификаторах транзакций и снимках состояния
9.27.9. Функции получения информации о фиксации транзакций #
Функции, показанные в Таблице 9.85, выдают информацию о времени фиксации уже завершённых транзакций. Результат этих функций будет полезным, только когда включён параметр конфигурации track_commit_timestamp и только для транзакций, зафиксированных после его включения. Информация о временной метке фиксации удаляется во время очистки.
Таблица 9.85. Функции получения информации о фиксации транзакций
9.27.10. Функции управления данными #
Функции, показанные в Таблице 9.86, выдают информацию, записываемую во время initdb
, например, версию каталога. Они также выводят сведения о журнале предзаписи и контрольных точках. Эта информация относится ко всему кластеру, а не к отдельной базе. Данные функции выдают практически ту же информацию, и из того же источника, что и pg_controldata.
Таблица 9.86. Функции управления данными
Функция Описание |
---|
Выдаёт информацию о текущем состоянии контрольных точек, показанную в Таблице 9.87. |
Выдаёт информацию о текущем состоянии управляющего файла, показанную в Таблице 9.88. |
Выдаёт информацию о состоянии инициализации кластера, показанную в Таблице 9.89. |
Выдаёт информацию о состоянии восстановления, как показано в Таблице 9.90. |
Таблица 9.87. Столбцы результата pg_control_checkpoint
Имя столбца | Тип данных |
---|---|
checkpoint_lsn | pg_lsn |
redo_lsn | pg_lsn |
redo_wal_file | text |
timeline_id | integer |
prev_timeline_id | integer |
full_page_writes | boolean |
next_xid | text |
next_oid | oid |
next_multixact_id | xid |
next_multi_offset | xid |
oldest_xid | xid |
oldest_xid_dbid | oid |
oldest_active_xid | xid |
oldest_multi_xid | xid |
oldest_multi_dbid | oid |
oldest_commit_ts_xid | xid |
newest_commit_ts_xid | xid |
checkpoint_time | timestamp with time zone |
Таблица 9.88. Столбцы результата pg_control_system
Имя столбца | Тип данных |
---|---|
pg_control_version | integer |
catalog_version_no | integer |
system_identifier | bigint |
pg_control_last_modified | timestamp with time zone |
pg_control_edition | text |
Таблица 9.89. Столбцы результата pg_control_init
Имя столбца | Тип данных |
---|---|
max_data_alignment | integer |
database_block_size | integer |
blocks_per_segment | integer |
wal_block_size | integer |
bytes_per_wal_segment | integer |
max_identifier_length | integer |
max_index_columns | integer |
max_toast_chunk_size | integer |
large_object_chunk_size | integer |
float8_pass_by_value | boolean |
data_page_checksum_version | integer |
Таблица 9.90. Столбцы результата pg_control_recovery
Имя столбца | Тип данных |
---|---|
min_recovery_end_lsn | pg_lsn |
min_recovery_end_timeline | integer |
backup_start_lsn | pg_lsn |
backup_end_lsn | pg_lsn |
end_of_backup_record_required | boolean |
9.27.11. Функции получения информации о версии #
Функции, перечисленные в Таблице 9.91, выводят информацию о версии.
Таблица 9.91. Функции получения информации о версии
Функция Описание |
---|
Выдаёт текстовую строку, описывающую версию сервера PostgreSQL. Эту информацию также можно получить из переменной server_version или, в более машинно-ориентированном формате, из переменной server_version_num. При разработке программ следует использовать функцию |
Возвращает строку с версией Unicode, используемой Postgres Pro. |
Возвращает строку с версией Unicode, используемой ICU, если сервер был создан с поддержкой ICU, и |
Выдаёт текстовую строку, описывающую версию сервера Postgres Pro. Эта функция устарела и будет удалена в будущих выпусках. Вместо неё используйте параметр конфигурации pgpro_version. |
Выдаёт текстовую строку, описывающую редакцию Postgres Pro, например |
Выдаёт идентификатор состояния исходного кода, из которого скомпилирован Postgres Pro. Эта функция устарела и будет удалена в будущих выпусках. Вместо неё используйте параметр конфигурации pgpro_build. |
9.27.12. Функции получения информации о сводках WAL #
Функции, перечисленные в Таблице 9.92, выводят информацию о создании сводок WAL. См. summarize_wal.
Таблица 9.92. Функции получения информации о сводках WAL