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

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

Эта опция похожа, но по историческим причинам не идентична указанию --section=data.

Перед восстановлением объектов базы данных выполните команды DROP для всех объектов, которые будут восстановлены. Этот параметр полезен для перезаписи существующей базы данных. Если какие-либо объекты не существуют в целевой базе данных, будут выведены игнорируемые сообщения об ошибках, если не указана опция --if-exists.

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

С помощью --create --pg_restore также восстанавливает комментарий к базе данных, если таковой имеется, а также любые настройки конфигурационных переменных, специфичные для этой базы данных, то есть любые команды ALTER DATABASE ... SET ... и ALTER ROLE ... IN DATABASE ... SET ... упоминающие эту базу данных. Права доступа к самой базе данных также восстанавливаются, если не указана опция --no-acl.

Когда используется этот параметр, база данных, указанная с помощью -d, используется только для выполнения начальных команд DROP DATABASE и CREATE DATABASE. Все данные восстанавливаются в базу данных, указанную в архиве.

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

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

Укажите выходной файл для сгенерированного сценария или для списка, когда используется с -l. Используйте - для stdout.

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

Сохранить только определение именованного индекса. Несколько индексов можно указать с помощью нескольких переключателей -I.

Запустите самые трудоемкие шаги pg_restore — те, которые загружают данные, создают индексы или создают ограничения — одновременно, используя до number-of-jobs параллельных сессий. Этот параметр может значительно сократить время восстановления большой базы данных на сервере, работающем на многопроцессорной машине. Этот параметр игнорируется при создании скрипта, а не при подключении непосредственно к серверу базы данных.

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

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

Сохраняются только пользовательские и архивные форматы каталога с этой опцией. Ввод должен быть обычным файлом или каталогом (а не, например, каналом или стандартным вводом). Кроме того, нельзя использовать несколько заданий вместе с опцией --single-transaction.

Содержимое архива: Список содержимого архива. Результат этой операции может быть использован в качестве входных данных для опции -L. Обратите внимание, что если используются фильтрующие переключатели, такие как -n или -t с опцией -l, они ограничат перечисленные элементы.

Восстановите только те элементы архива, которые перечислены в list-file, и восстановите их в порядке, в котором они появляются в файле. Обратите внимание, что если используются фильтрующие переключатели, такие как -n или -t с -L, они дополнительно ограничат восстанавливаемые элементы.

list-file обычно создается путем редактирования вывода предыдущей операции -l. Строки могут быть перемещены или удалены, а также могут быть закомментированы, поставив точку с запятой (;) в начале строки. См. примеры ниже.

Сохранить только объекты, которые находятся в указанной схеме. Можно указать несколько схем с помощью нескольких переключателей -n. Это можно совместить с опцией -t, чтобы восстановить только конкретную таблицу.

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

Когда оба -n и -N указаны для одного и того же имени схемы, выигрывает переключатель -N и схема исключается.

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

Восстановить только именованную функцию. Будьте внимательны при написании имени функции и аргументов точно так, как они указаны в таблице содержимого файла дампа. Можно указать несколько функций с помощью нескольких переключателей -P.

Эта опция устарела, но все еще принимается для обратной совместимости.

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

Этот параметр является обратным для параметра --data-only. Он похож на, но по историческим причинам не идентичен, указанию --section=pre-data --section=post-data.

(Не путайте это с опцией --schema, которая использует слово “схема” в другом значении).

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

Сохранить определение и/или данные только для указанной таблицы. В этом случае “таблица” включает в себя представления, материализованные представления, последовательности и внешние таблицы. Несколько таблиц могут быть выбраны путем указания нескольких переключателей -t. Этот параметр может быть объединен с параметром -n для указания таблиц(ы) в определенной схеме.

Восстановить только именованный триггер. Можно указать несколько триггеров с помощью нескольких переключателей -T.

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

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

Предотвратить восстановление привилегий доступа (команды grant/revoke).

Выполните восстановление как одну транзакцию (то есть оберните выполняемые команды в BEGIN/COMMIT). Это гарантирует, что либо все команды успешно завершатся, либо никакие изменения не будут применены. Этот параметр подразумевает --exit-on-error.

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

В настоящее время команды, генерируемые для --disable-triggers, должны выполняться от имени суперпользователя. Поэтому вы также должны указать имя суперпользователя с помощью -S или, желательно, запустить pg_restore от имени суперпользователя Tantor SE.

Увеличение допустимого размера загрузки ячейки таблицы до 2 ГБ для типов данных bytea и text. Этот аргумент активирует параметр конфигурации enable_large_allocations. Также включите этот параметр, когда pg_dump или pg_dumpall были вызваны с опцией --enable-large-allocations.

Этот параметр актуален только при восстановлении содержимого таблицы, у которой есть защита строк. По умолчанию, pg_restore устанавливает значение row_security в off, чтобы гарантировать, что все данные будут восстановлены в таблицу. Если у пользователя недостаточно привилегий для обхода защиты строк, то будет сгенерирована ошибка. Этот параметр указывает pg_restore установить значение row_security в on, позволяя пользователю попытаться восстановить содержимое таблицы с включенной защитой строк. Это все равно может завершиться неудачей, если у пользователя нет прав на вставку строк из дампа в таблицу.

Обратите внимание, что в настоящее время для этой опции также требуется, чтобы дамп был в формате INSERT, поскольку COPY FROM не поддерживает защиту строк.

Используйте команды DROP ... IF EXISTS для удаления объектов в режиме --clean. Это подавляет ошибки “не существует”, которые в противном случае могли бы быть сообщены. Этот параметр недействителен, если не указан также --clean.

Не выводить команды для восстановления комментариев, даже если они есть в архиве.

По умолчанию, данные таблицы восстанавливаются даже если команда создания таблицы не удалась (например, потому что она уже существует). С этой опцией данные для такой таблицы пропускаются. Такое поведение полезно, если целевая база данных уже содержит нужное содержимое таблицы. Например, вспомогательные таблицы для расширений Tantor SE, таких как PostGIS, могут уже быть загружены в целевую базу данных; указание этой опции предотвращает загрузку дублирующихся или устаревших данных в них.

Этот параметр действует только при восстановлении непосредственно в базу данных, а не при создании выходного SQL-скрипта.

Не выводить команды для восстановления публикаций, даже если они есть в архиве.

Не выводить команды для восстановления меток безопасности, даже если архив содержит их.

Не выводить команды для восстановления подписок, даже если они есть в архиве.

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

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

Восстановить только указанный раздел. Имя раздела может быть pre-data, data или post-data. Эту опцию можно указать несколько раз, чтобы выбрать несколько разделов. По умолчанию восстанавливаются все разделы.

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

Требуется, чтобы каждая схема (-n/--schema) и таблица (-t/--table) соответствовали хотя бы одной схеме/таблице в файле резервной копии.

Выводите команды SET SESSION AUTHORIZATION вместо команд ALTER OWNER для определения владения объектом. Это делает дамп более совместимым со стандартами, но в зависимости от истории объектов в дампе может не восстанавливаться должным образом.

Показать справку о командной строке для pg_restore и выйти.

Указывает имя хоста машины, на которой работает сервер. Если значение начинается с косой черты, оно используется в качестве каталога для Unix-доменного сокета. Значение по умолчанию берется из переменной среды PGHOST, если она установлена, в противном случае выполняется попытка подключения через Unix-доменный сокет.

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

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

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

Принудите pg_restore запросить пароль перед подключением к базе данных.

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

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

Параметры подключения по умолчанию

Определяет, следует ли использовать цвет в диагностических сообщениях. Возможные значения: always, auto и never.