pg_dumpall

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

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

Направляет вывод в указанный файл.

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

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

Не включает команды для установки владельца объектов в соответствии с исходной базой данных. По умолчанию pg_dump добавляет операторы ALTER OWNER или SET SESSION AUTHORIZATION, чтобы установить владельца созданных объектов базы данных. Эти команды вызовут ошибку при запуске скрипта, если он выполняется не суперпользователем или не пользователем, который владеет всеми объектами в скрипте. Чтобы создать скрипт, который может быть восстановлен любым пользователем и при этом назначит этому пользователю владение всеми объектами, используйте -O. Этот параметр имеет смысл только для формата обычного текста. Для архивных форматов его можно указать при вызове pg_restore.

Выгружает только роли, без баз данных и табличных пространств.

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

Задает имя суперпользователя для использования при деактивации триггеров. Актуально только при использовании параметра --disable-triggers. Рекомендуется не указывать этот параметр и вместо этого запускать полученный скрипт от имени суперпользователя.

Выгружает только табличные пространства, без баз данных и ролей.

Включает подробный режим вывода. В этом режиме pg_dump выводит детальные комментарии к объектам и время начала/окончания в дампе, а сообщения о ходе выполнения — в стандартный поток ошибок.

Выводит версию pg_dumpall и завершает работу.

Не включает в выгрузку привилегии доступа (команды GRANT/REVOKE).

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

Выгружает данные в виде команд INSERT с явным указанием имен столбцов (INSERT INTO <table> (<column>, …​) VALUES …​). Это делает восстановление значительно медленнее и в основном полезно для выгрузок, предназначенных для баз данных, несовместимых с PostgreSQL. При этом каждая строка создается отдельной командой, поэтому ошибка при загрузке затронет только эту строку, а не всю таблицу.

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

Применяется при создании выгрузки только с данными. Указывает pg_dumpall включить команды для временной деактивации триггеров в целевых таблицах при перезагрузке данных. Используется, если в таблицах есть триггеры, которые не должны срабатывать во время загрузки. Команды для --disable-triggers должны выполняться от имени суперпользователя. Либо укажите имя суперпользователя через -S, либо предпочтительнее запустите скрипт напрямую от имени суперпользователя.

Определяет применение условных команд (например, с добавлением выражения IF EXISTS) при удалении баз данных и других объектов. Может использоваться только совместно с параметром --clean.

Выгружает данные в виде команд INSERT вместо COPY. Это делает восстановление медленным, но полезно для выгрузок, которые нужно загрузить в СУБД, не основанные на PostgreSQL. Так как для каждой строки создается отдельная команда, ошибка при восстановлении затронет только эту строку, а не всю таблицу. Обратите внимание: восстановление может полностью не выполниться при изменении порядка столбцов. Параметр --column-inserts безопасен относительно изменения порядка столбцов, но еще медленнее.

Задает максимальное время ожидания получения разделяемой блокировки таблиц в начале выгрузки. Если таблица не будет заблокирована в течение указанного тайм-аута, выгрузка завершится с ошибкой. Тайм-аут можно указать в любом формате, принимаемом SET <statement_timeout>. Допустимые значения зависят от версии сервера, из которого выполняется выгрузка, но целое число миллисекунд принимается всеми версиями Greengage DB.

Не выгружает метки безопасности.

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

Не выгружает данные из нежурналируемых таблиц. Определения таблиц (схема) выгружаются как обычно; содержимое таблиц при этом не экспортируется.

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

Выгружает определения ресурсных очередей.

Выгружает определения ресурсных групп.

Выводит команды SQL-стандарта SET SESSION AUTHORIZATION вместо ALTER OWNER для установки владения объектами. Это повышает совместимость со стандартами, но может привести к некорректному восстановлению в зависимости от истории объектов. Выгрузка с SET SESSION AUTHORIZATION потребует привилегий суперпользователя для корректного восстановления, тогда как ALTER OWNER требует меньших привилегий.

Включает синтаксис Greengage DB в операторах CREATE TABLE. Это позволяет экспортировать политику распределения (выражения DISTRIBUTED BY или DISTRIBUTED RANDOMLY) таблиц Greengage DB, что важно при восстановлении в других кластерах Greengage DB.

Не выводит выражения распределения таблиц в операторах CREATE TABLE.

Отображает справку по аргументам командной строки pg_dumpall и завершает работу.

Указывает параметры для подключения к серверу в виде строки подключения. Дополнительную информацию см. в разделе Connection Strings документации PostgreSQL.

Имя хоста, на котором работает мастер Greengage DB. Если параметр не указан, читается из переменной окружения PGHOST; по умолчанию используется localhost.

Указывает имя базы данных для подключения и выгрузки глобальных объектов. Если параметр не указан, используется база данных postgres. Если база данных postgres не существует, используется база данных template1.

TCP-порт, на котором мастер Greengage DB прослушивает подключения. Если параметр не указан, читается из переменной окружения PGPORT; по умолчанию используется порт 5432.

Имя роли базы данных для подключения. Если параметр не указан, читается из переменной окружения PGUSER; по умолчанию используется имя текущей системной роли.

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

Принудительно запрашивает пароль при подключении.

Указывает роль, которая будет использоваться для создания выгрузки. После подключения к базе данных pg_dumpall выполнит команду SET ROLE <rolename>. Это полезно, когда аутентифицированному пользователю (через -U) не хватает прав, необходимых pg_dumpall, но он может переключиться на роль с нужными привилегиями. Некоторые инсталляции ограничивают прямой вход от имени суперпользователя; использование этого параметра позволяет создавать выгрузки, соблюдая политику безопасности.