pg_dumpall - Онлайн в облаке

ПРОГРАММА:

ИМЯ

pg_dumpall - извлечь кластер базы данных PostgreSQL в файл скрипта

СИНТАКСИС

pg_dumpall [вариант подключения...] [вариант...]

ОПИСАНИЕ

pg_dumpall - утилита для записи («дампинга») всех баз PostgreSQL кластера.
в один файл сценария. Файл сценария содержит команды SQL, которые можно использовать в качестве входных данных для
PSQL(1) для восстановления баз данных. Он делает это, вызывая pg_dump(1) для каждой базы данных в
кластер. pg_dumpall также выгружает глобальные объекты, общие для всех баз данных.
(pg_dump не сохраняет эти объекты.) В настоящее время сюда входит информация о базе данных.
пользователи и группы, табличные пространства и свойства, такие как разрешения на доступ, которые применяются к
базы данных в целом.

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

Скрипт SQL будет записан на стандартный вывод. Используйте параметр [-f | file] или оболочку
операторы, чтобы перенаправить его в файл.

pg_dumpall необходимо несколько раз подключиться к серверу PostgreSQL (один раз для каждой базы данных). Если
вы используете аутентификацию по паролю, он будет запрашивать пароль каждый раз. Удобно
есть ~ / .pgpass файл в таких случаях. См. Раздел 31.15, «Файл паролей» в
документация для получения дополнительной информации.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Следующие параметры командной строки управляют содержимым и форматом вывода.

-a
- только данные
Выгрузите только данные, а не схему (определения данных).

-c
--чистый
Включите команды SQL для очистки (удаления) баз данных перед их воссозданием. DROP команды
для ролей и табличных пространств.

-f имя файла
--file =имя файла
Отправить вывод в указанный файл. Если это не указано, используется стандартный вывод.

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

-o
--oids
Дамп идентификаторов объектов (OID) как часть данных для каждой таблицы. Используйте эту опцию, если
ваше приложение каким-то образом ссылается на столбцы OID (например, во внешнем ключе
ограничение). В противном случае эту опцию использовать не следует.

-O
--без собственника
Не выводите команды для установки владения объектами в соответствии с исходной базой данных. К
по умолчанию, проблемы с pg_dumpall ALTER ВЛАДЕЛЕЦ or УСТАНОВКА СЕССИЯ РАЗРЕШЕНИЕ заявления, чтобы установить
владение созданными элементами схемы. Эти операторы не сработают, если сценарий
запускается, если он не запущен суперпользователем (или тем же пользователем, которому принадлежат все объекты
в сценарии). Сделать скрипт, который может быть восстановлен любым пользователем, но даст это
право собственности пользователя на все объекты, укажите -O.

-r
--roles-только
Дамп только ролей, без баз данных или табличных пространств.

-s
--схема-только
Выгружать только определения объекта (схему), но не данные.

-S username
--superuser =username
Укажите имя пользователя суперпользователя, которое будет использоваться при отключении триггеров. Это актуально только
if - отключение-триггеры используется. (Обычно это лучше не указывать, а вместо этого
запустите получившийся скрипт от имени суперпользователя.)

-t
--tablespaces-только
Дамп только табличных пространств, без баз данных или ролей.

-v
--подробный
Задает подробный режим. Это заставит pg_dumpall выводить время начала / остановки в
файл дампа и сообщения о ходе выполнения до стандартной ошибки. Также будет включен подробный вывод
в pg_dump.

-V
--версия
Распечатайте версию pg_dumpall и выйдите.

-x
--нет привилегий
--no-acl
Запретить сброс прав доступа (команды предоставления / отзыва).

--binary-upgrade
Эта опция предназначена для использования утилит обновления на месте. Его использование для других целей является
не рекомендуется и не поддерживается. Поведение опции может измениться в будущих выпусках.
без предупреждения.

--столбцы-вставки
- атрибуты-вставки
Выгрузить данные как ВСТАВИТЬ команды с явными именами столбцов (INSERT INTO (см. таблицу ниже) (обзор,
...) ЦЕННОСТИ ...). Это сделает восстановление очень медленным; в основном это полезно для изготовления
дампы, которые можно загружать в базы данных, отличные от PostgreSQL.

--disable-доллар-котировка
Эта опция отключает использование долларовых кавычек для тел функций и заставляет их
заключаться в кавычки с использованием стандартного строкового синтаксиса SQL.

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

В настоящее время команды, испускаемые для - отключение-триггеры нужно делать как суперпользователь. Так,
вы также должны указать имя суперпользователя с -S, или, желательно, будьте осторожны, чтобы начать
получившийся скрипт как суперпользователь.

--if-существует
Используйте условные команды (например, добавьте предложение IF EXISTS) для очистки баз данных и других
объекты. Этот вариант недействителен, если --чистый также указано.

- вставки
Выгрузить данные как ВСТАВИТЬ команды (а не КОПИЯ). Это сделает восстановление очень медленным;
в основном это полезно для создания дампов, которые могут быть загружены в базы данных, отличные от PostgreSQL.
Обратите внимание, что восстановление может полностью завершиться неудачно, если вы изменили порядок столбцов. В
--столбцы-вставки вариант безопаснее, хотя и медленнее.

--lock-wait-timeout =Тайм-аут
Не ждите бесконечно, чтобы получить блокировки разделяемой таблицы в начале дампа.
Вместо этого выполнить сбой, если невозможно заблокировать таблицу в указанном Тайм-аут. Тайм-аут может
быть указанным в любом из форматов, принятых УСТАНОВКА Statement_timeout. Допустимые значения
различаются в зависимости от версии сервера, с которого выполняется дамп, но целое число
миллисекунды принимаются всеми версиями, начиная с 7.3. Эта опция игнорируется, когда
дамп с сервера до 7.3.

--нет-метки-безопасности
Не сбрасывайте защитные наклейки.

--нет-табличных пространств
Не выводите команды для создания табличных пространств и не выбирайте табличные пространства для объектов. С участием
эта опция, все объекты будут созданы в любом табличном пространстве, используемом по умолчанию во время
восстановить.

--no-unlogged-таблица-данные
Не выгружайте содержимое незарегистрированных таблиц. Эта опция не влияет на то,
не выгружаются определения таблиц (схемы); он только подавляет сброс таблицы
поле.

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

--use-set-session-авторизация
Выходной SQL-стандарт УСТАНОВКА СЕССИЯ РАЗРЕШЕНИЕ команды вместо ALTER ВЛАДЕЛЕЦ команды
для определения принадлежности объекта. Это делает дамп более совместимым со стандартами, но
в зависимости от истории объектов в дампе может не восстановиться должным образом.

-?
--Помогите
Показать справку об аргументах командной строки pg_dumpall и выйти.

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

-d Connstr
--dbname =Connstr
Задает параметры, используемые для подключения к серверу, в виде строки подключения. Видеть
Раздел 31.1.1, «Строки подключения», в документации для получения дополнительной информации.

Параметр называется --dbname для согласованности с другими клиентскими приложениями, но
поскольку pg_dumpall необходимо подключиться ко многим базам данных, имя базы данных в соединении
строка будет проигнорирована. Используйте параметр -l, чтобы указать имя базы данных, используемой для дампа
глобальные объекты и узнать, какие другие базы данных следует выгружать.

-h кашель
--host =кашель
Задает имя хоста компьютера, на котором работает сервер базы данных. Если
значение начинается с косой черты, оно используется как каталог для сокета домена Unix. В
по умолчанию берется из ПРИЗРАК переменная окружения, если установлена, иначе домен Unix
попытка подключения к сокету.

-l имя_базы_данных
--database =имя_базы_данных
Задает имя базы данных, к которой нужно подключиться для сброса глобальных объектов и
обнаружение, какие другие базы данных следует сбросить. Если не указано иное, postgres
будет использоваться база данных, а если она не существует, будет использоваться template1.

-p порт
--port =порт
Задает TCP-порт или расширение файла локального сокета домена Unix, на котором сервер
прослушивает соединения. По умолчанию ПГПОРТ переменная окружения, если установлена, или
встроенное значение по умолчанию.

-U username
--username =username
Имя пользователя для подключения.

-w
--нет пароля
Никогда не запрашивайте пароль. Если сервер требует аутентификации по паролю и
пароль недоступен другими способами, такими как файл .pgpass, соединение
попытка не удастся. Эта опция может быть полезна в пакетных заданиях и скриптах, где нет пользователей.
присутствует для ввода пароля.

-W
--пароль
Заставьте pg_dumpall запрашивать пароль перед подключением к базе данных.

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

Обратите внимание, что запрос пароля будет появляться снова для каждой базы данных, которая будет выгружена.
Обычно лучше настроить ~ / .pgpass файла, чем полагаться на ввод пароля вручную.

--role =имя роли
Задает имя роли, которая будет использоваться для создания дампа. Эта опция заставляет pg_dumpall
выдать УСТАНОВКА РОЛЬ имя роли команда после подключения к базе данных. Это полезно, когда
аутентифицированный пользователь (указанный -U) не имеет прав, необходимых для pg_dumpall, но
может переключиться на роль с необходимыми правами. Некоторые установки имеют политику
против входа в систему напрямую в качестве суперпользователя, и использование этой опции позволяет дампам быть
сделано без нарушения политики.

ОКРУЖАЮЩАЯ СРЕДА

ПРИЗРАК
ПОПЦИИ
ПГПОРТ
PGUSER
Параметры подключения по умолчанию

Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные среды
поддерживается libpq (см. Раздел 31.14, «Переменные среды» в документации).

ПРИМЕЧАНИЯ

Поскольку pg_dumpall вызывает внутри себя pg_dump, некоторые диагностические сообщения будут относиться к pg_dump.

После восстановления целесообразно запустить АНАЛИЗ в каждой базе данных, поэтому оптимизатор имеет полезные
статистика. Вы также можете запустить Vacuumdb -a -z проанализировать все базы данных.

pg_dumpall требует, чтобы все необходимые каталоги табличных пространств существовали до восстановления;
в противном случае создание базы данных не удастся для баз данных в расположениях, отличных от заданных по умолчанию.

ПРИМЕРЫ

Чтобы выгрузить все базы данных:

$ pg_dumpall > дБ.выход

Чтобы перезагрузить базы данных из этого файла, вы можете использовать:

$ PSQL -f дБ.выход Postgres

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

Используйте pg_dumpall онлайн с помощью сервисов onworks.net