Функции для системного администрирования

current_setting ( имя_параметра text [, может_отсутствовать boolean ] ) → text

Возвращает текущее значение параметра имя_параметра. Если такого параметра нет, current_setting выдает ошибку, если только не передан параметр может_отсутствовать со значением true (в этом случае возвращается NULL). Эта функция соответствует команде SQL SHOW.

current_setting('datestyle') → ISO, MDY

set_config ( имя_параметра text, новое_значение text, локальный boolean ) → text

Устанавливает для параметра имя_параметра новое_значение и возвращает это значение. Если параметр локальный равен true, новое значение будет применяться только в рамках текущей транзакции. Чтобы новое значение действовало до конца текущего сеанса, нужно задать этому параметру значение false. Эта функция соответствует команде SQL SET.

set_config('log_statement_stats', 'off', false) → off

pg_cancel_backend ( pid integer ) → boolean

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

pg_log_backend_memory_contexts ( pid integer ) → boolean

Запрашивает протоколирование в журнал информации о контекстах памяти обслуживающего процесса с заданным PID. Эта информация будет выводиться в сообщениях уровня LOG, которые появятся в журнале сервера, исходя из заданной конфигурации журнала (подробную информацию см. в разделе Регистрация ошибок и протоколирование), но не будут передаваться клиенту, независимо от значения client_min_messages. Только суперпользователи могут запрашивать протоколирование информации о контекстах памяти.

pg_reload_conf () → boolean

Заставляет все процессы сервера QHB перезагрузить их файлы конфигурации. (Для запуска этой операции посылается сигнал SIGHUP процессу qhbmaster, который, в свою очередь, посылает SIGHUP всем своим дочерним процессам.) Перед перезагрузкой можно воспользоваться представлениями pg_file_settings и pg_hba_file_rules для проверки файлов конфигурации на предмет возможных ошибок.

pg_rotate_logfile () → boolean

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

pg_terminate_backend ( pid integer, время_ожидания bigint DEFAULT 0 ) → boolean

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

pg_create_restore_point ( имя text ) → pg_lsn

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

pg_current_wal_flush_lsn () → pg_lsn

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

pg_current_wal_insert_lsn () → pg_lsn

Возвращает текущую позицию добавления в журнале упреждающей записи (см. примечания ниже).

pg_current_wal_lsn () → pg_lsn

Возвращает текущую позицию записи в журнале упреждающей записи (см. примечания ниже).

pg_start_backup ( метка text [, быстро boolean [, эксклюзивный_режим boolean ]] ) → pg_lsn

Подготавливает сервер к началу резервного копирования в режиме реального времени. Единственный требуемый параметр — произвольная пользовательская метка для резервной копии. (Обычно это имя, под которым будет храниться файл дампа.) Если необязательный второй параметр имеет значение true, функция pg_start_backup должна выполняться как можно быстрее. При этом будет принудительно выполнена контрольная точка, что вызовет кратковременный всплеск операций ввода/вывода, замедлив тем самым параллельно выполняемые запросы. Необязательный третий параметр указывает, будет ли резервное копирование выполняться в эксклюзивном (по умолчанию) или неэксклюзивном режиме.
При копировании в эксклюзивном режиме эта функция записывает файл метки (backup_label) и, если есть ссылки в каталоге pg_tblspc/, файл карты табличных пространств (tablespace_map) в каталог данных кластера баз данных, выполняет процесс контрольной точки, а затем возвращает начальную позицию резервной копии в журнале упреждающей записи. (Это результирующее значение можно игнорировать, но в некоторых случаях оно может быть полезным.) При копировании в неэксклюзивном режиме содержимое этих файлов возвращается функцией pg_stop_backup и должно быть скопировано в область резервного копирования самим пользователем.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_stop_backup ( эксклюзивный_режим boolean [, ждать_архивирования boolean ] ) → setof record ( lsn pg_lsn, файл_метки text, файл_карты_табл_пространств text )

Завершает выполнение эксклюзивного или неэксклюзивного копирования в режиме реального времени. Значение параметра эксклюзивный_режим должно соответствовать тому, что было передано в предыдущем вызове функции pg_start_backup. При копировании в эксклюзивном режиме pg_stop_backup удаляет файл метки и файл карты табличных пространств (если он существует), созданные pg_start_backup. При копировании в неэксклюзивном режиме ожидаемое содержимое этих файлов возвращается в виде части результата этой функции и должно быть записано в файлы в области резервного копирования (а не в каталоге данных).
Также имеется необязательный второй параметр типа boolean. Если он равен false, функция вернет результат сразу после окончания резервного копирования, не дожидаясь архивирования WAL. Такое поведение полезно только для программ резервного копирования, независимо мониторящих архивирование WAL. В иных случаях архив WAL, требующийся для согласованности резервной копии, может отсутствовать, делая копию бесполезной. По умолчанию или когда этот параметр равен true, pg_stop_backup будет ждать завершения архивирования WAL, если оно включено. (Для резервного сервера это означает, что функция будет ждать, только при условии archive_mode = always. При низкой активности записи на основном сервере может быть полезно выполнить на нем pg_switch_wal, чтобы запустить немедленное переключение сегмента.)
При выполнении на основном сервере эта функция также создает файл истории резервного копирования в архивной области журнала упреждающей записи. В файле истории содержится метка, заданная при вызове pg_start_backup, начальная и конечная позиция копии в журнале, а также время начала и окончания копирования. После записи конечной позиции текущая позиция добавления в журнале упреждающей записи автоматически перемещается в следующий файл журнала, чтобы файл конечной позиции можно было немедленно заархивировать для завершения резервного копирования.
Результатом этой функции является единственная запись. Столбец lsn содержит позицию завершения резервного копирования в журнале упреждающей записи (которую, опять же, можно игнорировать). Второй и третий столбцы после окончания эксклюзивного копирования содержат NULL, а после неэксклюзивного — ожидаемое содержимое файлов метки и карты табличных пространств.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_stop_backup () → pg_lsn

Завершает выполнение эксклюзивного копирования в режиме реального времени. Эта упрощенная версия равнозначна вызову pg_stop_backup(true, true), за исключением того, что она возвращает в результате только pg_lsn.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_is_in_backup () → boolean

Возвращает true, если в данный момент выполняется эксклюзивное резервное копирование в режиме реального времени.

pg_backup_start_time () → timestamp with time zone

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

pg_switch_wal () → pg_lsn

Производит принудительное переключение сервера на новый файл журнала упреждающей записи, что позволяет архивировать текущий файл (в предположении, что вы используете непрерывное архивирование). Результат — конечная позиция в только что законченном журнале упреждающей записи плюс 1. Если с момента последнего переключения файлов не было активности, pg_switch_wal ничего не делает и возвращает начальную позицию в журнале упреждающей записи, используемом в данный момент.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_walfile_name ( lsn pg_lsn ) → text

Преобразует позицию в журнале упреждающей записи в имя файла WAL, содержащего эту позицию.

pg_walfile_name_offset ( lsn pg_lsn ) → record ( имя_файла text, смещение_файла integer )

Преобразует позицию в журнале упреждающей записи в имя файла WAL и байтовое смещение в этом файле.

pg_wal_lsn_diff ( lsn1 pg_lsn, lsn2 pg_lsn ) → numeric

Вычисляет разницу в байтах (lsn1 - lsn2) между двумя позициями в журнале упреждающей записи. Эту разницу можно использовать с pg_stat_replication или с некоторыми из функций, приведенных в Таблице 87, для определения задержки репликации.

pg_is_in_recovery () → boolean

Возвращает true, если восстановление еще продолжается.

pg_last_wal_receive_lsn () → pg_lsn

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

pg_last_wal_replay_lsn () → pg_lsn

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

pg_last_xact_replay_timestamp () → timestamp with time zone

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

pg_is_wal_replay_paused () → boolean

Возвращает true, если запрошена приостановка восстановления.

pg_get_wal_replay_pause_state () → text

Возвращает состояние приостановки восстановления. Возвращаемые значения: not paused, если приостановка не запрашивалась, pause requested, если приостановка запрашивалась, но восстановление еще не приостановлено, и paused, если восстановление действительно приостановлено.

pg_promote ( ожидание boolean DEFAULT true, секунды_ожидания integer DEFAULT 60 ) → boolean

Повышает статус резервного сервера до основного. Если параметр ожидание равен true (по умолчанию), функция дожидается завершения повышения либо пока пройдут секунды_ожидания и возвращает true, если повышение завершилось успешно, и false в противном случае. Если параметр ожидание равен false, функция возвращает true сразу после отправки процессу qhbmaster сигнала SIGUSR1, запускающего повышение.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_wal_replay_pause () → void

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

pg_wal_replay_resume () → void

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

pg_export_snapshot () → text

Сохраняет текущий снимок состояния транзакции и возвращает строку типа text, идентифицирующую этот снимок. Эта строка должна передаваться (вне базы данных) клиентам, желающим импортировать этот снимок. Снимок доступен для импортирования, только пока не завершится экспортирующая его транзакция.
При необходимости транзакция может экспортировать более одного снимка. Обратите внимание, что это может быть полезно только для транзакций уровня READ COMMITTED, поскольку транзакции уровня изоляции REPEATABLE READ и выше используют один снимок на протяжении всего своего существования. После того, как транзакция экспортировала какие-либо снимки, ее нельзя сделать подготовленной с помощью команды PREPARE TRANSACTION.

pg_create_physical_replication_slot ( имя_слота name [, мгновенный_резерв boolean, временный boolean ] ) → record ( имя_слота name, lsn pg_lsn )

Создает новый физический слот репликации с именем имя_слота. Когда необязательный второй параметр равен true, это указывает, что LSN для этого слота репликации должен быть зарезервирован немедленно; в противном случае LSN резервируется при первом подключении клиента потоковой репликации. Передача изменений из физического слота возможна только по протоколу потоковой репликации. Когда необязательный третий параметр временный равен true, это указывает, что слот не должен постоянно храниться на диске и предназначен к использованию только в текущем сеансе. Временные слоты также освобождаются при любой ошибке. Эта функция соответствует команде протокола репликации CREATE_REPLICATION_SLOT ... PHYSICAL.

pg_drop_replication_slot ( имя_слота name ) → void

Удаляет физический или логический слот с именем имя_слота. Аналогична команде протокола репликации DROP_REPLICATION_SLOT. Для логических слотов эта функция должна вызываться при подключении к той же базе данных, в которой был создан слот.

pg_create_logical_replication_slot ( имя_слота name, плагин name [, временный boolean, две_фазы boolean ] ) → record ( имя_слота name, lsn pg_lsn )

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

pg_copy_physical_replication_slot ( имя_исходного_слота name, имя_целевого_слота name [, временный boolean ] ) → record ( имя_слота name, lsn pg_lsn )

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

pg_copy_logical_replication_slot ( имя_исходного_слота name, имя_целевого_слота name [, временный boolean [, плагин name ]] ) → record ( имя_слота name, lsn pg_lsn )

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

pg_logical_slot_get_changes ( имя_слота name, до_lsn pg_lsn, до_n_изменений integer, VARIADIC параметры text[] ) → setof record ( lsn pg_lsn, id_транзакции xid, данные text )

Возвращает изменения в слоте имя_слота, начиная с последней точки, с которой ранее были получены изменения. Если параметры до_lsn и до_n_изменений равны NULL, логическое декодирование будет продолжаться до конца WAL. Если до_lsn отличен от NULL, декодирование затронет только транзакции, зафиксированные до заданного LSN. Если до_n_изменений отличен от NULL, декодирование остановится, когда число строк, выданных при декодировании, превысит заданное значение. Однако обратите внимание, что фактическое число возвращенных строк может быть больше, поскольку это ограничение проверяется только после добавления строк, выданных при декодировании очередной зафиксированной транзакции.

pg_logical_slot_peek_changes ( имя_слота name, до_lsn pg_lsn, до_n_изменений integer, VARIADIC параметры text[] ) → setof record ( lsn pg_lsn, id_транзакции xid, данные text )

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

pg_logical_slot_get_binary_changes ( имя_слота name, до_lsn pg_lsn, до_n_изменений integer, VARIADIC параметры text[] ) → setof record ( lsn pg_lsn, id_транзакции xid, данные bytea )

Ведет себя так же, как функция pg_logical_slot_get_changes(), за исключением того, что изменения возвращаются в типе bytea.

pg_logical_slot_peek_binary_changes ( имя_слота name, до_lsn pg_lsn, до_n_изменений integer, VARIADIC параметры text[] ) → setof record ( lsn pg_lsn, id_транзакции xid, данные bytea )

Ведет себя так же, как функция pg_logical_slot_peek_changes(), за исключением того, что изменения возвращаются в типе bytea.

pg_replication_slot_advance ( имя_слота name, до_lsn pg_lsn ) → record ( имя_слота name, итоговый_lsn pg_lsn )

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

pg_replication_origin_create ( имя_узла text ) → oid

Создает источник репликации с заданным внешним именем и возвращает назначенный ему внутренний идентификатор.

pg_replication_origin_drop ( имя_узла text ) → void

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

pg_replication_origin_oid ( имя_узла text ) → oid

Ищет источник репликации по имени и возвращает внутренний идентификатор. Если такой источник не находится, возвращается NULL.

pg_replication_origin_session_setup ( имя_узла text ) → void

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

pg_replication_origin_session_reset () → void

Отменяет действие функции pg_replication_origin_session_setup().

pg_replication_origin_session_is_setup () → boolean

Возвращает true, если в текущем сеансе был выбран источник репликации.

pg_replication_origin_session_progress ( сброс_на_диск boolean ) → pg_lsn

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

pg_replication_origin_xact_setup ( исходный_lsn pg_lsn, исх_метка_времени timestamp with time zone ) → void

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

pg_replication_origin_xact_reset () → void

Отменяет действие функции pg_replication_origin_xact_setup().

pg_replication_origin_advance ( имя_узла text, lsn pg_lsn ) → void

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

pg_replication_origin_progress ( имя_узла text, сброс_на_диск boolean ) → pg_lsn

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

pg_logical_emit_message ( часть_транзакции boolean, префикс text, содержимое text ) → pg_lsn

pg_logical_emit_message ( часть_транзакции boolean, prefix text, содержимое bytea ) → pg_lsn

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

pg_column_size ( "any" ) → integer

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

pg_column_compression ( "any" ) → text

Показывает алгоритм сжатия, который использовался при сжатии отдельного значения переменной длины. Если значение не сжато, возвращает NULL.

pg_database_size ( name ) → bigint

pg_database_size ( oid ) → bigint

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

pg_indexes_size ( regclass ) → bigint

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

pg_relation_size ( отношение regclass [, ветвь text ] ) → bigint

Вычисляет объем дискового пространства, занимаемый одной «ветвью» указанного отношения. (Обратите внимание, что в большинстве случаев удобнее использовать более высокоуровневые функции pg_total_relation_size или pg_table_size, суммирующие размер всех ветвей.) С одним аргументом она выдает размер основной ветви данных отношения. Во втором аргументе можно передать название ветви, которую нужно проверить:

• main возвращает размер основной ветви данных этого отношения.
• fsm возвращает размер карты свободного пространства (см. раздел Карта свободного пространства), связанной с этим отношением.
• vm возвращает размер карты видимости (см. раздел Карта видимости), связанной с этим отношением.
• init возвращает размер ветви инициализации (если таковая имеется), связанной с этим отношением.

pg_size_bytes ( text ) → bigint

Преобразует размер в формате, удобном для восприятия человеком (который возвращает функция pg_size_pretty), в байты.

pg_size_pretty ( bigint ) → text

pg_size_pretty ( numeric ) → text

Преобразует размер в байтах в более удобный для восприятия человеком формат с единицами измерения размера (bytes, kB, MB, GB или TB соответственно). Обратите внимание, что эти единицы являются степенями 2, а не 10, поэтому 1kB — это 1024 байта, 1MB — это 1024² = 1048576 байта и т. д.

pg_table_size ( regclass ) → bigint

Вычисляет объем дискового пространства, занимаемый указанной таблицей, за исключением индексов (но включая ее TOAST-таблицу (если таковая имеется), карту свободного пространства и карту видимости).

pg_tablespace_size ( name ) → bigint

pg_tablespace_size ( oid ) → bigint

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

pg_total_relation_size ( regclass ) → bigint

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

pg_relation_filenode ( отношение regclass ) → oid

Возвращает номер «файлового узла», связанного с указанным отношением. Файловый узел является основным компонентом имени файла, используемого для отношения (подробную информацию см. в разделе Структура файлов базы данных). Для большинства отношений результат совпадает с результатом функции pg_class.relfilenode, на для некоторых системных каталогов relfilenode равен нулю, и нужно использовать данную функцию, чтобы получить верное значение. Если передать этой функции отношение, не имеющее хранилища, например представление, она возвращает NULL.

pg_relation_filepath ( отношение regclass ) → text

Возвращает имя полного пути к файлу отношения (относительно каталога данных кластера баз данных — PGDATA).

pg_filenode_relation ( табличное_пространство oid, файловый_узел oid ) → regclass

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

pg_collation_actual_version ( oid ) → text

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

pg_import_system_collations ( схема regnamespace ) → integer

Добавляет правила сортировки в системный каталог pg_collation с учетом всех локалей, которые она находит в операционной системе. Эту информацию использует qhb_bootstrap; подробную информацию см. в подразделе Управление правилами сортировки. Если позднее в операционную систему устанавливаются дополнительные локали, эту функцию можно запустить снова, чтобы добавить правила сортировки для новых локалей. Локали, соответствующие существующим записям в pg_collation, будут пропущены. (Но объекты правил сортировки, относящиеся к локалям, которых больше не существует в операционной системе, этой функцией не удаляются.) В параметре схема обычно передается pg_catalog, но это не обязательное требование; правила сортировки могут быть установлены и в какую-нибудь другую схему. Эта функция возвращает число созданных ей новых объектов правил сортировки. Вызывать эту функцию могут только суперпользователи.

pg_partition_tree ( regclass ) → setof record ( id_отношения regclass, id_родителя regclass, является_листовой boolean, уровень integer )

Перечисляет таблицы или индексы в дереве партиционирования заданной партиционированной таблицы или партиционированного индекса, по одной строке на каждую партицию. Предоставляемая информация включает OID партиции, OID ее непосредственного родителя, логическое значение, указывающее, является ли партиция концевой вершиной структуры, и целое число, отражающее ее уровень в иерархии. Значение уровня 0 означает вводимую таблицу или индекс, 1 — непосредственные дочерние партиции, 2 — партиции этих партиций и т. д. Если заданное отношение не существует или не является партицией или партиционированной таблицей, возвращает пустой результат.

pg_partition_ancestors ( regclass ) → setof regclass

Перечисляет вышестоящие отношения для заданной партиции, включая ее саму. Если заданное отношение не существует или не является партицией или партиционированной таблицей, возвращает пустой результат.

pg_partition_root ( regclass ) → regclass

Возвращает самое верхнее родительское отношение в дереве партиционирования, к которому принадлежит заданное отношение. Если заданное отношение не существует или не является партицией или партиционированной таблицей, возвращает NULL.

brin_summarize_new_values ( индекс regclass ) → integer

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

brin_summarize_range ( индекс regclass, номер_блока bigint ) → integer

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

brin_desummarize_range ( индекс regclass, номер_блока bigint ) → void

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

gin_clean_pending_list ( индекс regclass ) → bigint

Очищает список ожидания указанного индекса GIN путем массового перемещения записей из него в основную структуру данных GIN. Возвращает число страниц, убранных из списка ожидания. Если аргументом является индекс GIN, построенный с выключенным параметром fastupdate, очистка не производится и результат равен нулю, поскольку у этого индекса нет списка ожидания. Подробную информацию о списке ожидания и параметре fastupdate см. в подразделе Методика быстрого обновления GIN и разделе Советы и рекомендации по применению GIN.

pg_ls_dir ( имя_каталога text [, может_отсутствовать boolean, включать_каталоги_с_точками boolean ] ) → setof text

Возвращает имена всех файлов (а также каталогов и других специальных файлов) в указанном каталоге. Параметр включать_каталоги_с_точками показывает, будут ли в результирующий набор включаться каталоги «.» и «..»; по умолчанию они исключаются. Включить их имеет смысл, когда параметр может_отсутствовать равен true, чтобы пустой каталог можно было отличить от несуществующего.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_ls_logdir () → setof record ( имя text, размер bigint, модификация timestamp with time zone )

Возвращает имя, размер и время последнего изменения (mtime) всех обычных файлов в каталоге журналов сервера. Файлы с именами, начинающимися с точки, каталоги и другие специальные файлы исключаются.
По умолчанию эту функцию могут вызывать только суперпользователи и члены роли pg_monitor, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_ls_waldir () → setof record ( имя text, размер bigint, модификация timestamp with time zone )

Возвращает имя, размер и время последнего изменения (mtime) всех обычных файлов в каталоге журнала упреждающей записи (WAL) сервера. Файлы с именами, начинающимися с точки, каталоги и другие специальные файлы исключаются.
По умолчанию эту функцию могут вызывать только суперпользователи и члены роли pg_monitor, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_ls_archive_statusdir () → setof record ( имя text, размер bigint, модификация timestamp with time zone )

Возвращает имя, размер и время последнего изменения (mtime) всех обычных файлов в каталоге состояния архива WAL (pg_wal/archive_status) сервера. Файлы с именами, начинающимися с точки, каталоги и другие специальные файлы исключаются.
По умолчанию эту функцию могут вызывать только суперпользователи и члены роли pg_monitor, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_ls_tmpdir ( [ табличное_пространство oid ] ) → setof record ( имя text, размер bigint, модификация timestamp with time zone )

Возвращает имя, размер и время последнего изменения (mtime) всех обычных файлов во временном каталоге файлов для табличного_пространства. Если табличное_пространство не задано, проверяется табличное пространство pg_default. Файлы с именами, начинающимися с точки, каталоги и другие специальные файлы исключаются.
По умолчанию эту функцию могут вызывать только суперпользователи и члены роли pg_monitor, но право EXECUTE на ее выполнение можно дать и другим пользователям.

pg_read_file ( имя_файла text [, смещение bigint, длина bigint [, может_отсутствовать boolean ]] ) → text

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

pg_read_binary_file ( имя_файла text [, смещение bigint, длина bigint [, может_отсутствовать boolean ]] ) → bytea

Возвращает текстовый файл, целиком или частично. Эта функция идентична pg_read_file, за исключением того, что она может читать произвольные двоичные данные, возвращая результат в значении типа bytea, а не text; соответственно, никакие проверки кодировки не осуществляются.
По умолчанию эту функцию могут вызывать только суперпользователи, но право EXECUTE на ее выполнение можно дать и другим пользователям.
В сочетании с функцией convert_from эту функцию можно использовать для чтения текстового файла в заданной кодировке и преобразования в кодировку базы данных:

SELECT convert_from(pg_read_binary_file('file_in_utf8.txt'), 'UTF8');

pg_stat_file ( имя_файла text [, может_отсутствовать boolean ] ) → record ( размер bigint, обращение timestamp with time zone, модификация timestamp with time zone, изменение timestamp with time zone, является_каталогом boolean )

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

pg_advisory_lock ( ключ bigint ) → void

pg_advisory_lock ( ключ1 integer, ключ2 integer ) → void

Получает исключительную рекомендательную блокировку уровня сеанса, при необходимости ожидая ее.

pg_advisory_lock_shared ( ключ bigint ) → void

pg_advisory_lock_shared ( ключ1 integer, ключ2 integer ) → void

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

pg_advisory_unlock ( ключ bigint ) → boolean

pg_advisory_unlock ( ключ1 integer, ключ2 integer ) → boolean

Освобождает полученную ранее исключительную рекомендательную блокировку уровня сеанса. Если блокировка успешно освобождена, возвращает true. Если сеанс не удерживал эту блокировку, возвращается false, а кроме того сервер выдаст предупреждение SQL.

pg_advisory_unlock_all () → void

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

pg_advisory_unlock_shared ( ключ bigint ) → boolean

pg_advisory_unlock_shared ( ключ1 integer, ключ2 integer ) → boolean

Освобождает полученную ранее разделяемую рекомендательную блокировку уровня сеанса. Если блокировка успешно освобождена, возвращает true. Если сеанс не удерживал эту блокировку, возвращается false, а кроме того сервер выдаст предупреждение SQL.

pg_advisory_xact_lock ( ключ bigint ) → void

pg_advisory_xact_lock ( ключ1 integer, ключ2 integer ) → void

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

pg_advisory_xact_lock_shared ( ключ bigint ) → void

pg_advisory_xact_lock_shared ( ключ1 integer, ключ2 integer ) → void

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

pg_try_advisory_lock ( ключ bigint ) → boolean

pg_try_advisory_lock ( ключ1 integer, ключ2 integer ) → boolean

Получает исключительную рекомендательную блокировку уровня сеанса, если она доступна. Эта функция либо немедленно получает блокировку и возвращает true, либо сразу возвращает false, если блокировку нельзя получить немедленно.

pg_try_advisory_lock_shared ( ключ bigint ) → boolean

pg_try_advisory_lock_shared ( ключ1 integer, ключ2 integer ) → boolean

Получает разделяемую рекомендательную блокировку уровня сеанса, если она доступна. Эта функция либо немедленно получает блокировку и возвращает true, либо сразу возвращает false, если блокировку нельзя получить немедленно.

pg_try_advisor_xact_lock ( ключ bigint ) → boolean

pg_try_advisory_xact_lock ( ключ1 integer, ключ2 integer ) → boolean

Получает исключительную рекомендательную блокировку уровня транзакции, если она доступна. Эта функция либо немедленно получает блокировку и возвращает true, либо сразу возвращает false, если блокировку нельзя получить немедленно.

pg_try_advisory_xact_lock_shared ( ключ bigint ) → boolean

pg_try_advisory_xact_lock_shared ( ключ1 integer, ключ2 integer ) → boolean

Получает разделяемую рекомендательную блокировку уровня транзакции, если она доступна. Эта функция либо немедленно получает блокировку и возвращает true, либо сразу возвращает false, если блокировку нельзя получить немедленно.

qhb_timer_report имя text значение int8

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

qhb_counter_increase_by имя text значение int8

Увеличивает значение «счетчика» для метрики с указанным именем. Во втором аргументе передается число наносекунд, на которое увеличивается это значение.

qhb_gauge_add имя text значение int8

Увеличивает значение типа gauge для метрики с указанным именем. Во втором аргументе передается число наносекунд, на которое увеличивается это значение.

qhb_gauge_sub имя text значение int8

Уменьшает значение типа gauge для метрики с указанным именем. Во втором аргументе передается число наносекунд, на которое уменьшается это значение.

qhb_gauge_update имя text значение int8

Устанавливает значение типа gauge для метрики с указанным именем.

qhb_annotation текст text [тег ...]

Отправляет аннотации в Grafana. В аргументе текст передается текст этой аннотации. В необязательном аргументе тег указываются теги для аннотации; можно указать произвольное число тегов.