pgpro_controldata
pgpro_controldata — вывести управляющую информацию кластера БД PostgreSQL/Postgres Pro и параметры совместимости кластера и/или сервера.
Синтаксис
pgpro_controldata
[параметр
...]
Описание
pgpro_controldata
выводит управляющую информацию, в частности, версию каталога, записываемую программой initdb
при инициализации любого кластера PostgreSQL/Postgres Pro. Данная утилита также выводит сведения о журнале предзаписи, включая данные контрольной точки. Эта информация относится ко всему кластеру, а не к отдельной базе данных.
pgpro_controldata
также помогает проверить совместимость между серверами и кластерами БД PostgreSQL/Postgres Pro. Эта программа может вывести параметры, влияющие на совместимость, и определить, совместим ли сервер с кластером, сравнивая эти параметры.
Параметры
pgpro_controldata
принимает в командной строке параметры, описанные далее. В случае запуска без параметров pgpro_controldata
просто выводит управляющую информацию так, как это делает pg_controldata. Заметьте, что аргументы командной строки, связанные с совместимостью, -P
и -S
, работают в паре как один аргумент -C
.
Параметры общего назначения
-B
--bindir
Задаёт каталог с исполняемыми файлами PostgreSQL/Postgres Pro; требуется для получения параметров совместимости сервера.
-D
каталог_данных
--pgdata
=каталог_данных
Указывает размещение конфигурационных файлов кластера. Если этот ключ опущен, используется значение переменной окружения
PGDATA
.-V
--version
Показать версию pgpro_controldata, а затем завершиться.
-?
--help
Показать справку по аргументам командной строки pgpro_controldata, а затем завершиться.
Параметры, связанные с совместимостью
-C
--compatibility-check
Вывести все параметры целевого кластера, от которых зависит совместимость выбранного сервера и кластера, и установить, совместимы ли они.
Путь к целевому каталогу данных, доступному для чтения, передаётся в аргументе
-D
или в переменной окруженияPGDATA
.Если параметр
-B
опущен, подразумевается текущий сервер.Эта проверка будет полноценной, только если данные кластера и сервер рассчитаны на одну архитектуру процессора и одинаковый порядок байтов.
-P
--cluster-compatibility-params
Вывести все параметры целевого кластера, которые могут повлиять на совместимость.
Путь к целевому каталогу данных, доступному для чтения, передаётся в аргументе
-D
или в переменной окруженияPGDATA
.Эта проверка будет полноценной, только если данные кластера и сервер рассчитаны на одну архитектуру процессора и одинаковый порядок байтов.
-S
--server-compatibility-params
Вывести все параметры указанного или текущего сервера, которые могут повлиять на совместимость.
Если параметр
-B
опущен, подразумевается текущий сервер.
Переменные окружения
PGDATA
Каталог размещения данных кластера по умолчанию
PG_COLOR
Выбирает вариант использования цвета в диагностических сообщениях. Возможные значения:
always
(всегда),auto
(автоматически) иnever
(никогда).