mirror of
https://github.com/pgadmin-org/pgadmin4.git
synced 2025-02-25 18:55:31 -06:00
Added new/missing parameters to pg_restore. #6562
This commit is contained in:
@@ -38,21 +38,22 @@ restore process:
|
||||
* Use the drop-down listbox next to *Rolename* to specify the role that will be
|
||||
used to authenticate with the server during the restore process.
|
||||
|
||||
Click the *Data/Objects* tab to continue. Use the fields on the *Data/Objects*
|
||||
tab to specify options related to data or pgAdmin objects that correspond to
|
||||
*pg_restore* options.
|
||||
Click the *Data Options* tab to continue. Use the fields in the *Data Options*
|
||||
tab to provide options related to data or pgAdmin objects that correspond to *pg_restore*.
|
||||
|
||||
.. image:: images/restore_sections.png
|
||||
:alt: Restore dialog options section
|
||||
:align: center
|
||||
|
||||
* Use the switches in the **Sections** box to specify the content that will be
|
||||
* Move switches in the **Sections** field box to specify the content that will be
|
||||
restored:
|
||||
|
||||
* Move the switch next to *Pre-data* towards right position to restore all
|
||||
data definition items not included in the data or post-data item lists.
|
||||
|
||||
* Move the switch next to *Data* towards right position to restore actual
|
||||
table data, large-object contents, and sequence values.
|
||||
|
||||
* Move the switch next to *Post-data* towards right position position to restore
|
||||
definitions of indexes, triggers, rules, and constraints (other than
|
||||
validated check constraints).
|
||||
@@ -61,11 +62,12 @@ tab to specify options related to data or pgAdmin objects that correspond to
|
||||
:alt: Restore dialog sections section
|
||||
:align: center
|
||||
|
||||
* Use the switches in the **Type of objects** box to specify the objects that
|
||||
* Move switches in the **Type of objects** field box to specify the objects that
|
||||
will be restored:
|
||||
|
||||
* Move the switch next to *Only data* towards right position to limit the
|
||||
restoration to data.
|
||||
|
||||
* Move the switch next to *Only schema* to limit the restoration to
|
||||
schema-level database objects.
|
||||
|
||||
@@ -73,62 +75,94 @@ tab to specify options related to data or pgAdmin objects that correspond to
|
||||
:alt: Restore dialog do not save section
|
||||
:align: center
|
||||
|
||||
* Use the switches in the **Do not save** box to specify which objects will not
|
||||
* Move switches in the **Do not save** box to specify which objects will not
|
||||
be restored:
|
||||
|
||||
* Move the switch next to *Owner* towards right position to exclude commands
|
||||
that set object ownership.
|
||||
* Move the switch next to *Privilege* towards right position to exclude
|
||||
|
||||
* Move the switch next to *Privileges* towards right position to exclude
|
||||
commands that create access privileges.
|
||||
* Move the switch next to *Tablespace* towards right position to exclude
|
||||
|
||||
* Move the switch next to *Tablespaces* towards right position to exclude
|
||||
tablespaces.
|
||||
|
||||
* Move the switch next to *Comments* towards right position to exclude
|
||||
commands that set the comments. **Note:** This option is visible only for
|
||||
database server greater than or equal to 11.
|
||||
|
||||
Click the *Options* tab to continue. Use these additional fields to specify
|
||||
options like cleaning before restore, verbose message or using set session
|
||||
authorization that correspond to *pg_restore* options.
|
||||
* Move the switch next to *Publications* towards right position to exclude
|
||||
publications.
|
||||
|
||||
* Move the switch next to *Subscriptions* towards right position to exclude
|
||||
subscriptions.
|
||||
|
||||
* Move the switch next to *Security labels* towards right position to exclude
|
||||
Security labels.
|
||||
|
||||
* Move the switch next to *Table access methods* towards right position to exclude
|
||||
Table access methods. **Note:** This option is visible only for
|
||||
database server greater than or equal to 15.
|
||||
|
||||
.. image:: images/restore_queries.png
|
||||
:alt: Restore dialog queries section
|
||||
:align: center
|
||||
|
||||
* Use the switches in the **Queries** box to specify the type of statements that
|
||||
should be included in the restore:
|
||||
Click the *Query Options* tab to continue. Use these additional fields to specify
|
||||
the type of statements that should be included in the restore:
|
||||
|
||||
|
||||
* Move the switch next to *Include CREATE DATABASE statement* towards right position
|
||||
to include a command that creates a new database before performing the restore.
|
||||
|
||||
* Move the switch next to *Clean before restore* towards right position to
|
||||
drop each existing database object (and data) before restoring.
|
||||
|
||||
* Move the switch next to *Include IF EXISTS clause* towards right
|
||||
position to add an IF EXISTS clause to drop databases and other objects.
|
||||
This option is not valid unless *Clean before restore* is also set.
|
||||
|
||||
* Move the switch next to *Single transaction* towards right position to
|
||||
execute the restore as a single transaction (that is, wrap the emitted
|
||||
commands in *BEGIN/COMMIT*). This ensures that either all the commands
|
||||
complete successfully, or no changes are applied. This option implies
|
||||
*--exit-on-error*.
|
||||
|
||||
.. image:: images/restore_disable.png
|
||||
:alt: Restore dialog disable section
|
||||
.. image:: images/restore_table.png
|
||||
:alt: Restore dialog tables section
|
||||
:align: center
|
||||
|
||||
* Use the switches in the **Disable** box to specify the type of statements that
|
||||
should be excluded from the restore:
|
||||
Click the *Table Options* tab to continue. Use the fields in the *Table Options*
|
||||
tab related to tables that should be included in the backup.
|
||||
|
||||
* Move the switch next to *Trigger* (active when creating a data-only
|
||||
restore) towards right position to include commands that will disable
|
||||
triggers on the target table while the data is being loaded.
|
||||
* Move the switch next to *No data for Failed Tables* towards right position
|
||||
* Move the switch next to *Enable row security* towards right position to
|
||||
set row_security to on instead, allowing the user to dump the parts of the
|
||||
contents of the table that they have access to. This option is relevant
|
||||
only when dumping the contents of a table which has row security.
|
||||
|
||||
* Move the switch next to *No data for failed tables* towards right position
|
||||
to ignore data that fails a trigger.
|
||||
|
||||
Click the *Options* tab to continue. Use the fields in the *Options*
|
||||
tab to provide other restore options.
|
||||
|
||||
.. image:: images/restore_miscellaneous.png
|
||||
:alt: Restore dialog miscellaneous section
|
||||
:align: center
|
||||
|
||||
* Use the switches in the **Miscellaneous/Behavior** box to specify
|
||||
* Move switches in the **Disable** box to specify the type of statements that
|
||||
should be excluded from the restore:
|
||||
|
||||
* Move the switch next to *Triggers* (active when creating a data-only
|
||||
restore) towards right position to include commands that will disable
|
||||
triggers on the target table while the data is being loaded.
|
||||
|
||||
* Move switches in the **Miscellaneous/Behavior** box to specify
|
||||
miscellaneous restore options:
|
||||
|
||||
* Move the switch next to *Verbose messages* towards left to instruct
|
||||
*pg_restore* to exclude verbose messages.
|
||||
|
||||
* Move the switch next to *Use SET SESSION AUTHORIZATION* towards right position
|
||||
to include a statement that will use a SET SESSION AUTHORIZATION
|
||||
command to determine object ownership (instead of an ALTER OWNER command).
|
||||
@@ -138,6 +172,9 @@ authorization that correspond to *pg_restore* options.
|
||||
The default is to continue and to display a count of errors at the end of
|
||||
the restore.
|
||||
|
||||
* Use the *Exclude schema* field to not dump schemas whose name matches
|
||||
pattern.
|
||||
|
||||
When you’ve specified the details that will be incorporated into the pg_restore
|
||||
command, click the *Restore* button to start the process, or click the *Cancel*
|
||||
button to exit without saving your work. A popup will confirm if the restore is
|
||||
@@ -145,4 +182,4 @@ successful.
|
||||
|
||||
pgAdmin will run the restore process in background. You can view all the background
|
||||
process with there running status and logs on the :ref:`Processes <processes>`
|
||||
tab
|
||||
tab
|
||||
|
Reference in New Issue
Block a user