F.1. adminpack#
F.1. adminpack
adminpack
предоставляет ряд вспомогательных функций, которые pgAdmin и другие инструменты администрирования и управления могут использовать для предоставления дополнительных возможностей, таких как удаленное управление журналами сервера.
По умолчанию, использование всех этих функций разрешено только суперпользователю, но может быть разрешено другим пользователям с помощью команды GRANT
.
Все функции, показанные в Таблица F.1, обеспечивают
запись файлов на машине, на которой размещен сервер. (См. также
функции в Таблица 9.99, которые
обеспечивают только чтение).
Можно получить доступ только к файлам внутри каталога кластера базы данных, если
пользователь является суперпользователем или имеет привилегии одной из
ролей pg_read_server_files
или
pg_write_server_files
, соответствующих
функции, но допустимы как относительные, так и абсолютные пути.
Таблица F.1. adminpack
Функции
Функция Описание |
---|
Записывает или добавляет в текстовый файл. |
Сбрасывает файл или каталог на диск. |
Переименовывает файл. |
Удаляет файл. |
Перечисляет файлы журналов в каталоге |
pg_file_write
записывает указанные данные data
в файл с именем filename
. Если append
равно false, файл не должен уже существовать. Если append
равно true, файл может уже существовать и будет добавлен к нему, если это так.
Возвращает количество записанных байтов.
pg_file_sync
синхронизирует указанный файл или каталог, указанный в filename
. В случае ошибки (например, если указанный файл отсутствует) будет сгенерировано исключение. Обратите внимание, что data_sync_retry не влияет на это функцию, поэтому даже в случае неудачи при сбросе файлов базы данных не будет вызвана ошибка уровня PANIC.
pg_file_rename
переименовывает файл. Если archivename
не указан или равен NULL, он просто переименовывает oldname
в newname
(который не должен уже существовать). Если указан archivename
, сначала он переименовывает newname
в archivename
(который не должен уже существовать), а затем переименовывает oldname
в newname
. В случае неудачи второго шага переименования, он попытается переименовать archivename
обратно в newname
перед сообщением об ошибке. Возвращает true в случае успеха, false, если исходный файл (или файлы) отсутствуют или недоступны для записи; в других случаях генерируются ошибки.
pg_file_unlink
удаляет указанный файл.
Возвращает true в случае успеха, false, если указанный файл отсутствует
или вызов unlink()
завершается неудачно; в других случаях генерируются ошибки.
pg_logdir_ls
возвращает временные метки начала и пути
имен всех файлов журнала в каталоге log_directory.
Параметр log_filename должен иметь свое
значение по умолчанию (postgresql-%Y-%m-%d_%H%M%S.log
), чтобы использовать эту
функцию.