Системные информационные функции и операторы

В Таблице 65 приведено несколько функций, которые извлекают информацию о сеансе и системе.

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

Таблица 65. Функции получения информации о сеансе

Примечание
Функции current_catalog, current_role, current_schema, current_user, session_user и user имеют специальный синтаксический статус в SQL: они должны вызываться без завершающих скобок. В QHB скобки можно использовать с current_schema, но не с остальными функциями.

Функция session_user обычно возвращает имя пользователя, инициировавшего текущее соединение с базой данных; но суперпользователи могут изменить эту настройку с помощью команды SET SESSION AUTHORIZATION. Функция current_user возвращает идентификатор пользователя, который применим для проверки прав доступа. Обычно это тот же пользователь, что и пользователь сеанса, но его можно сменить с помощью команды SET ROLE. Он также изменяется во время выполнения функций с атрибутом SECURITY DEFINER. На языке Unix пользователь сеанса — это «реальный пользователь», а текущий пользователь — «эффективный пользователь». Функции current_role и user являются синонимами функции current_user. (Стандарт SQL проводит различие между current_role и current_user, но QHB этого не делает, поскольку объединяет пользователей и роли в единый вид сущностей).

В Таблице 66 перечислены функции, позволяющие программно запрашивать информацию о правах доступа к объекту. (Дополнительную информацию о правах см. в разделе Права.) В этих функциях пользователя, для которого запрашиваются права, можно указать по имени или 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');

Таблица 66. Функции для проверки прав доступа

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

Таблица 67. Операторы для aclitem

В Таблице 68 приведены некоторые дополнительные функции для управления типом aclitem.

Таблица 68. Функции для aclitem

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

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

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

Таблица 69. Функции проверки видимости схемы

Всем этим функциям для идентификации подлежащего проверке объекта требуется его OID. Если нужно проверить объект по имени, удобно использовать типы-псевдонимы OID (regclass, regtype, regprocedure, regoperator, regconfig или regdictionary), например:

SELECT pg_type_is_visible('myschema.widget'::regtype);

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

В Таблице 70 перечислены функции, которые извлекают информацию из системных каталогов.

Таблица 70. Функции для получения информации из системных каталогов

SELECT pg_typeof(33);
     pg_typeof
    -----------
      integer 

SELECT typlen FROM pg_type WHERE oid = pg_typeof(33);
     typlen
    --------
          4 

SELECT collation for (description) FROM pg_description LIMIT 1;
     pg_collation_for
    ------------------
      "default" 

SELECT collation for ('foo' COLLATE "de_DE");
     pg_collation_for
    ------------------
     "de_DE" 

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

Таблица 71. Свойства столбца индекса

Таблица 72. Свойства индекса

Таблица 73. Свойства индексного метода доступа

В Таблице 74 перечислены функции, связанные с идентификацией и адресацией объектов базы данных.

Таблица 74. Функции для получения информации и адресации объектов

Функции, приведенные в Таблице 75, извлекают комментарии, ранее сохраненные командой COMMENT. Если найти комментарий для заданных параметров невозможно, возвращается NULL.

Таблица 75. Функции для получения комментариев

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

Таблица 76. Функции для получения информации об идентификаторах транзакций и снимках состояния

Внутренний тип идентификатора транзакции xid имеет ширину 32 бита и значения в нем повторяются каждые 4 миллиарда транзакций. Однако функции, перечисленные в Таблице 76, используют 64-битный тип xid8, значения которого не повторяются на протяжении жизни сервера и который при необходимости можно преобразовать в тип xid. Тип данных pg_snapshot хранит информацию о видимости транзакций в конкретный момент времени. Его компоненты описаны в Таблице 77. Текстовым представлением pg_snapshot является xmin:xmax:xip_list. Например, запись 10:20:10,14,15 означает xmin=10, xmax=20, xip_list=10, 14, 15.

Таблица 77. Компоненты снимка состояния

В более старых версиях QHB отсутствовал тип xid8, поэтому предоставлялись варианты этих функций, в которых для представления 64-битных XID использовался тип bigint, а также, соответственно, имелся отдельный тип для информации о снимке состояния — txid_snapshot. В названиях этих старых функций фигурирует txid. Они все еще поддерживаются в целях обратной совместимости, но могут быть удалены в будущем. См. Таблицу 78.

Таблица 78. Устаревшие функции для получения информации об идентификаторах транзакций и снимках состояния

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

Таблица 79. Функции для получения информации о зафиксированных транзакциях

Функции, приведенные в Таблице 80, выдают информацию, инициализированную во время qhb_bootstrap, например версию каталога. Они также показывают информацию о протоколировании в журнал упреждающей записи и обработке контрольных точек. Эта информация относится ко всему кластеру, а не к какой-либо одной базе данных. Эти функции по большей части предоставляют ту же информацию и из того же источника, что и приложение qhb_controldata.

Таблица 80. Функции для управления данными

Таблица 81. Столбцы результата pg_control_checkpoint

Таблица 82. Столбцы результата pg_control_system

Таблица 83. Столбцы результата pg_control_init

Таблица 84. Столбцы результата pg_control_recovery