Updated screenshots and descriptions for Backup and Restore dialog.

This commit is contained in:
Rahul Shirsat 2022-01-07 11:35:40 +05:30 committed by Akshay Joshi
parent 7cc76c7d2d
commit 65a6c18263
31 changed files with 70 additions and 59 deletions

View File

@ -67,8 +67,8 @@ Use the fields in the *General* tab to specify parameters for the backup:
* Use the dropdown listbox next to *Rolename* to specify the role that owns the * Use the dropdown listbox next to *Rolename* to specify the role that owns the
backup. backup.
Click the *Dump options* tab to continue. Use the box fields in the *Dump Click the *Data/Objects* tab to continue. Use the fields in the *Data/Objects*
options* tab to provide options for *pg_dump*. tab to provide options related to data or pgAdmin objects that correspond to *pg_dump*.
.. image:: images/backup_sections.png .. image:: images/backup_sections.png
:alt: Sections option on backup dialog :alt: Sections option on backup dialog
@ -77,13 +77,13 @@ options* tab to provide options for *pg_dump*.
* Move switches in the **Sections** field box to select a portion of the object * Move switches in the **Sections** field box to select a portion of the object
that will be backed up. that will be backed up.
* Move the switch next to *Pre-data* to the *Yes* position to include all * Move the switch next to *Pre-data* towards right position to include all
data definition items not included in the data or post-data item lists. data definition items not included in the data or post-data item lists.
* Move the switch next to *Data* to the *Yes* position to backup actual table * Move the switch next to *Data* towards right position to backup actual table
data, large-object contents, and sequence values. data, large-object contents, and sequence values.
* Move the switch next to *Post-data* to the *Yes* position to include * Move the switch next to *Post-data* towards right position to include
definitions of indexes, triggers, rules, and constraints other than definitions of indexes, triggers, rules, and constraints other than
validated check constraints. validated check constraints.
@ -94,13 +94,13 @@ options* tab to provide options for *pg_dump*.
* Move switches in the **Type of objects** field box to specify details about * Move switches in the **Type of objects** field box to specify details about
the type of objects that will be backed up. the type of objects that will be backed up.
* Move the switch next to *Only data* to the *Yes* position to limit the back * Move the switch next to *Only data* towards right position to limit the back
up to data. up to data.
* Move the switch next to *Only schema* to limit the back up to schema-level * Move the switch next to *Only schema* to limit the back up to schema-level
database objects. database objects.
* Move the switch next to *Blobs* to the *No* position to exclude large * Move the switch next to *Blobs* towards left position to exclude large
objects in the backup. objects in the backup.
.. image:: images/backup_do_not_save.png .. image:: images/backup_do_not_save.png
@ -110,22 +110,26 @@ options* tab to provide options for *pg_dump*.
* Move switches in the **Do not save** field box to select the objects that will * Move switches in the **Do not save** field box to select the objects that will
not be included in the backup. not be included in the backup.
* Move the switch next to *Owner* to the *Yes* position to exclude commands * Move the switch next to *Owner* towards right position to exclude commands
that set object ownership. that set object ownership.
* Move the switch next to *Privilege* to the *Yes* position to exclude * Move the switch next to *Privilege* towards right position to exclude
commands that create access privileges. commands that create access privileges.
* Move the switch next to *Tablespace* to the *Yes* position to exclude * Move the switch next to *Tablespace* towards right position to exclude
tablespaces. tablespaces.
* Move the switch next to *Unlogged table data* to the *Yes* position to * Move the switch next to *Unlogged table data* towards right position to
exclude the contents of unlogged tables. exclude the contents of unlogged tables.
* Move the switch next to *Comments* to the *Yes* position to exclude * Move the switch next to *Comments* towards right position to exclude
commands that set the comments. **Note:** This option is visible only for commands that set the comments. **Note:** This option is visible only for
database server greater than or equal to 11. database server greater than or equal to 11.
Click the *Options* tab to continue. Use these additional fields to specify
options like including ddl statements, verbose message or using set session
authorization corresponding to *pg_dump* options.
.. image:: images/backup_queries.png .. image:: images/backup_queries.png
:alt: Queries option on backup dialog :alt: Queries option on backup dialog
:align: center :align: center
@ -133,24 +137,24 @@ options* tab to provide options for *pg_dump*.
* Move switches in the **Queries** field box to specify the type of statements * Move switches in the **Queries** field box to specify the type of statements
that should be included in the backup. that should be included in the backup.
* Move the switch next to *Use Column Inserts* to the *Yes* position to dump * Move the switch next to *Use Column Inserts* towards right position to dump
the data in the form of INSERT statements and include explicit column the data in the form of INSERT statements and include explicit column
names. Please note: this may make restoration from backup slow. names. Please note: this may make restoration from backup slow.
* Move the switch next to *Use Insert commands* to the *Yes* position to * Move the switch next to *Use Insert commands* towards right position to
dump the data in the form of INSERT statements rather than using a COPY dump the data in the form of INSERT statements rather than using a COPY
command. Please note: this may make restoration from backup slow. command. Please note: this may make restoration from backup slow.
* Move the switch next to *Include CREATE DATABASE statement* to the *Yes* * Move the switch next to *Include CREATE DATABASE statement* towards right
position to include a command in the backup that creates a new database position to include a command in the backup that creates a new database
when restoring the backup. when restoring the backup.
* Move the switch next to *Include DROP DATABASE statement* to the *Yes* * Move the switch next to *Include DROP DATABASE statement* towards right
position to include a command in the backup that will drop any existing position to include a command in the backup that will drop any existing
database object with the same name before recreating the object during a database object with the same name before recreating the object during a
backup. backup.
* Move the switch next to *Load Via Partition Root* to the *Yes* position, * Move the switch next to *Load Via Partition Root* towards right position,
so when dumping a COPY or INSERT statement for a partitioned table, target so when dumping a COPY or INSERT statement for a partitioned table, target
the root of the partitioning hierarchy which contains it rather than the the root of the partitioning hierarchy which contains it rather than the
partition itself. **Note:** This option is visible only for database server partition itself. **Note:** This option is visible only for database server
@ -164,10 +168,10 @@ options* tab to provide options for *pg_dump*.
that should be excluded from the backup. that should be excluded from the backup.
* Move the switch next to *Trigger* (active when creating a data-only backup) * Move the switch next to *Trigger* (active when creating a data-only backup)
to the *Yes* position to include commands that will disable triggers on the towards right position to include commands that will disable triggers on the
target table while the data is being loaded. target table while the data is being loaded.
* Move the switch next to *$ quoting* to the *Yes* position to enable dollar * Move the switch next to *$ quoting* towards right position to enable dollar
quoting within function bodies; if disabled, the function body will be quoting within function bodies; if disabled, the function body will be
quoted using SQL standard string syntax. quoted using SQL standard string syntax.
@ -178,16 +182,16 @@ options* tab to provide options for *pg_dump*.
* Move switches in the **Miscellaneous** field box to specify miscellaneous * Move switches in the **Miscellaneous** field box to specify miscellaneous
backup options. backup options.
* Move the switch next to *With OIDs* to the *Yes* position to include object * Move the switch next to *With OIDs* towards right position to include object
identifiers as part of the table data for each table. identifiers as part of the table data for each table.
* Move the switch next to *Verbose messages* to the *No* position to instruct * Move the switch next to *Verbose messages* towards left position to instruct
*pg_dump* to exclude verbose messages. *pg_dump* to exclude verbose messages.
* Move the switch next to *Force double quotes on identifiers* to the *Yes* * Move the switch next to *Force double quotes on identifiers* towards right
position to force the quoting of all identifiers. position to force the quoting of all identifiers.
* Move the switch next to *Use SET SESSION AUTHORIZATION* to the *Yes* * Move the switch next to *Use SET SESSION AUTHORIZATION* towards right
position to include a statement that will use a SET SESSION AUTHORIZATION position to include a statement that will use a SET SESSION AUTHORIZATION
command to determine object ownership (instead of an ALTER OWNER command). command to determine object ownership (instead of an ALTER OWNER command).

View File

@ -28,10 +28,13 @@ Use the fields in the *General* tab to specify the following:
:alt: Type of objects option on backup server dialog :alt: Type of objects option on backup server dialog
:align: center :align: center
Click the *Data/Objects* tab to continue. Use the fields in the *Data/Objects*
tab to provide options related to data or pgAdmin objects that correspond to *pg_dump*.
* Move switches in the **Type of objects** field box to specify details about * Move switches in the **Type of objects** field box to specify details about
the type of objects that will be backed up. the type of objects that will be backed up.
* Move the switch next to *Only data* to the *Yes* position to limit the back * Move the switch next to *Only data* towards right position to limit the back
up to data. up to data.
* Move the switch next to *Only schema* to limit the back up to schema-level * Move the switch next to *Only schema* to limit the back up to schema-level
@ -44,19 +47,19 @@ Use the fields in the *General* tab to specify the following:
* Move switches in the **Do not save** field box to select the objects that will * Move switches in the **Do not save** field box to select the objects that will
not be included in the backup. not be included in the backup.
* Move the switch next to *Owner* to the *Yes* position to exclude commands * Move the switch next to *Owner* towards right position to exclude commands
that set object ownership. that set object ownership.
* Move the switch next to *Privilege* to the *Yes* position to exclude * Move the switch next to *Privilege* towards right position to exclude
commands that create access privileges. commands that create access privileges.
* Move the switch next to *Tablespace* to the *Yes* position to exclude * Move the switch next to *Tablespace* towards right position to exclude
tablespaces. tablespaces.
* Move the switch next to *Unlogged table data* to the *Yes* position to * Move the switch next to *Unlogged table data* towards right position to
exclude the contents of unlogged tables. exclude the contents of unlogged tables.
* Move the switch next to *Comments* to the *Yes* position to exclude * Move the switch next to *Comments* towards right position to exclude
commands that set the comments. **Note:** This option is visible only for commands that set the comments. **Note:** This option is visible only for
database server greater than or equal to 11. database server greater than or equal to 11.
@ -67,15 +70,15 @@ Use the fields in the *General* tab to specify the following:
* Move switches in the **Queries** field box to specify the type of statements * Move switches in the **Queries** field box to specify the type of statements
that should be included in the backup. that should be included in the backup.
* Move the switch next to *Use Column Inserts* to the *Yes* position to dump * Move the switch next to *Use Column Inserts* towards right position to dump
the data in the form of INSERT statements and include explicit column the data in the form of INSERT statements and include explicit column
names. Please note: this may make restoration from backup slow. names. Please note: this may make restoration from backup slow.
* Move the switch next to *Use Insert commands* to the *Yes* position to dump * Move the switch next to *Use Insert commands* towards right position to dump
the data in the form of INSERT statements rather than using a COPY command. the data in the form of INSERT statements rather than using a COPY command.
Please note: this may make restoration from backup slow. Please note: this may make restoration from backup slow.
* Move the switch next to *Include DROP DATABASE statement* to the *Yes* * Move the switch next to *Include DROP DATABASE statement* towards right
position to include a command in the backup that will drop any existing position to include a command in the backup that will drop any existing
database object with the same name before recreating the object during a database object with the same name before recreating the object during a
backup. backup.
@ -89,10 +92,10 @@ Use the fields in the *General* tab to specify the following:
that should be excluded from the backup. that should be excluded from the backup.
* Move the switch next to *Trigger* (active when creating a data-only backup) * Move the switch next to *Trigger* (active when creating a data-only backup)
to the *Yes* position to include commands that will disable triggers on the towards right position to include commands that will disable triggers on the
target table while the data is being loaded. target table while the data is being loaded.
* Move the switch next to *$ quoting* to the *Yes* position to enable dollar * Move the switch next to *$ quoting* towards right position to enable dollar
quoting within function bodies; if disabled, the function body will be quoting within function bodies; if disabled, the function body will be
quoted using SQL standard string syntax. quoted using SQL standard string syntax.
@ -103,16 +106,16 @@ Use the fields in the *General* tab to specify the following:
* Move switches in the **Miscellaneous** field box to specify miscellaneous * Move switches in the **Miscellaneous** field box to specify miscellaneous
backup options. backup options.
* Move the switch next to *With OIDs* to the *Yes* position to include object * Move the switch next to *With OIDs* towards right position to include object
identifiers as part of the table data for each table. identifiers as part of the table data for each table.
* Move the switch next to *Verbose messages* to the *No* position to instruct * Move the switch next to *Verbose messages* towards left position to instruct
*pg_dump* to exclude verbose messages. *pg_dump* to exclude verbose messages.
* Move the switch next to *Force double quotes on identifiers* to the *Yes* * Move the switch next to *Force double quotes on identifiers* towards right
position to force the quoting of all identifiers. position to force the quoting of all identifiers.
* Move the switch next to *Use SET SESSION AUTHORIZATION* to the *Yes* * Move the switch next to *Use SET SESSION AUTHORIZATION* towards right
position to include a statement that will use a SET SESSION AUTHORIZATION position to include a statement that will use a SET SESSION AUTHORIZATION
command to determine object ownership (instead of an ALTER OWNER command). command to determine object ownership (instead of an ALTER OWNER command).

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 34 KiB

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 66 KiB

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 44 KiB

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 298 KiB

After

Width:  |  Height:  |  Size: 218 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 46 KiB

After

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 55 KiB

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 166 KiB

After

Width:  |  Height:  |  Size: 154 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 50 KiB

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 39 KiB

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 54 KiB

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 184 KiB

After

Width:  |  Height:  |  Size: 131 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 148 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 36 KiB

View File

@ -38,8 +38,9 @@ restore process:
* Use the drop-down listbox next to *Rolename* to specify the role that will be * 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. used to authenticate with the server during the restore process.
Click the *Restore options* tab to continue. Use the fields on the *Restore Click the *Data/Objects* tab to continue. Use the fields on the *Data/Objects*
options* tab to specify options that correspond to *pg_restore* options. tab to specify options related to data or pgAdmin objects that correspond to
*pg_restore* options.
.. image:: images/restore_sections.png .. image:: images/restore_sections.png
:alt: Restore dialog options section :alt: Restore dialog options section
@ -48,11 +49,11 @@ options* tab to specify options that correspond to *pg_restore* options.
* Use the switches in the **Sections** box to specify the content that will be * Use the switches in the **Sections** box to specify the content that will be
restored: restored:
* Move the switch next to *Pre-data* to the *Yes* position to restore all * 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. data definition items not included in the data or post-data item lists.
* Move the switch next to *Data* to the *Yes* position to restore actual * Move the switch next to *Data* towards right position to restore actual
table data, large-object contents, and sequence values. table data, large-object contents, and sequence values.
* Move the switch next to *Post-data* to the *Yes* position to restore * Move the switch next to *Post-data* towards right position position to restore
definitions of indexes, triggers, rules, and constraints (other than definitions of indexes, triggers, rules, and constraints (other than
validated check constraints). validated check constraints).
@ -63,7 +64,7 @@ options* tab to specify options that correspond to *pg_restore* options.
* Use the switches in the **Type of objects** box to specify the objects that * Use the switches in the **Type of objects** box to specify the objects that
will be restored: will be restored:
* Move the switch next to *Only data* to the *Yes* position to limit the * Move the switch next to *Only data* towards right position to limit the
restoration to data. restoration to data.
* Move the switch next to *Only schema* to limit the restoration to * Move the switch next to *Only schema* to limit the restoration to
schema-level database objects. schema-level database objects.
@ -75,16 +76,20 @@ options* tab to specify options that correspond to *pg_restore* options.
* Use the switches in the **Do not save** box to specify which objects will not * Use the switches in the **Do not save** box to specify which objects will not
be restored: be restored:
* Move the switch next to *Owner* to the *Yes* position to exclude commands * Move the switch next to *Owner* towards right position to exclude commands
that set object ownership. that set object ownership.
* Move the switch next to *Privilege* to the *Yes* position to exclude * Move the switch next to *Privilege* towards right position to exclude
commands that create access privileges. commands that create access privileges.
* Move the switch next to *Tablespace* to the *Yes* position to exclude * Move the switch next to *Tablespace* towards right position to exclude
tablespaces. tablespaces.
* Move the switch next to *Comments* to the *Yes* position to exclude * Move the switch next to *Comments* towards right position to exclude
commands that set the comments. **Note:** This option is visible only for commands that set the comments. **Note:** This option is visible only for
database server greater than or equal to 11. 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.
.. image:: images/restore_queries.png .. image:: images/restore_queries.png
:alt: Restore dialog queries section :alt: Restore dialog queries section
:align: center :align: center
@ -92,12 +97,11 @@ options* tab to specify options that correspond to *pg_restore* options.
* Use the switches in the **Queries** box to specify the type of statements that * Use the switches in the **Queries** box to specify the type of statements that
should be included in the restore: should be included in the restore:
* Move the switch next to *Include CREATE DATABASE statement* to the *Yes* * Move the switch next to *Include CREATE DATABASE statement* towards right position
position to include a command that creates a new database before performing to include a command that creates a new database before performing the restore.
the restore. * Move the switch next to *Clean before restore* towards right position to
* Move the switch next to *Clean before restore* to the *Yes* position to
drop each existing database object (and data) before restoring. drop each existing database object (and data) before restoring.
* Move the switch next to *Single transaction* to the *Yes* position to * Move the switch next to *Single transaction* towards right position to
execute the restore as a single transaction (that is, wrap the emitted execute the restore as a single transaction (that is, wrap the emitted
commands in *BEGIN/COMMIT*). This ensures that either all the commands commands in *BEGIN/COMMIT*). This ensures that either all the commands
complete successfully, or no changes are applied. This option implies complete successfully, or no changes are applied. This option implies
@ -111,9 +115,9 @@ options* tab to specify options that correspond to *pg_restore* options.
should be excluded from the restore: should be excluded from the restore:
* Move the switch next to *Trigger* (active when creating a data-only * Move the switch next to *Trigger* (active when creating a data-only
restore) to the *Yes* position to include commands that will disable restore) towards right position to include commands that will disable
triggers on the target table while the data is being loaded. triggers on the target table while the data is being loaded.
* Move the switch next to *No data for Failed Tables* to the *Yes* position * Move the switch next to *No data for Failed Tables* towards right position
to ignore data that fails a trigger. to ignore data that fails a trigger.
.. image:: images/restore_miscellaneous.png .. image:: images/restore_miscellaneous.png
@ -123,13 +127,13 @@ options* tab to specify options that correspond to *pg_restore* options.
* Use the switches in the **Miscellaneous/Behavior** box to specify * Use the switches in the **Miscellaneous/Behavior** box to specify
miscellaneous restore options: miscellaneous restore options:
* Move the switch next to *Verbose messages* to the *No* position to instruct * Move the switch next to *Verbose messages* towards left to instruct
*pg_restore* to exclude verbose messages. *pg_restore* to exclude verbose messages.
* Move the switch next to *Use SET SESSION AUTHORIZATION* to the *Yes* * Move the switch next to *Use SET SESSION AUTHORIZATION* towards right position
position to include a statement that will use a SET SESSION AUTHORIZATION to include a statement that will use a SET SESSION AUTHORIZATION
command to determine object ownership (instead of an ALTER OWNER command). command to determine object ownership (instead of an ALTER OWNER command).
* Move the switch next to *Exit on error* to the *Yes* position to instruct * Move the switch next to *Exit on error* towards right position to instruct
*pg_restore* to exit restore if there is an error in sending SQL commands. *pg_restore* to exit restore if there is an error in sending SQL commands.
The default is to continue and to display a count of errors at the end of The default is to continue and to display a count of errors at the end of
the restore. the restore.