pgadmin4/docs/en_US/move_objects.rst
2018-06-15 09:14:12 +01:00

45 lines
2.2 KiB
ReStructuredText

.. _move_objects:
****************************
`Move Objects Dialog`:index:
****************************
Use the *Move Objects* dialog to to move database objects from one tablespace to another tablespace.
The *Move Objects* dialog organizes the movement of database objects with the *General* tab; the *SQL* tab displays the SQL code generated by dialog selections.
.. image:: images/move_objects_general.png
:alt: Move objects dialog general tab
Use the fields in the *General* tab to identify the items that will be moved and the tablespace to which they will be moved:
* Use the *New tablespace* drop-down listbox to select a pre-existing tablespace to which the object will be moved. (To create a tablespace, use the *Tablespace* dialog; access the dialog by right clicking *Tablespaces* in the *pgAdmin* tree control and selecting *Create Tablespace...* from the context-menu.)
* Use the *Object type* drop-down listbox to select from the following:
* Select *All* to move all tables, indexes, and materialized views from the current tablespace (currently selected in the *pgAdmin* tree control) to the new tablespace.
* Select *Tables* to move tables from the current tablespace to the new tablespace.
* Select *Indexes* to move indexes from the current tablespace to the new tablespace.
* Select *Materialized views* to move materialized views from the current tablespace to the new tablespace.
* Use the *Object owner* drop-down listbox to select the role that owns the objects selected in the *Object type* field. This field is optional.
Click the *SQL* tab to continue.
Your entries in the *Move Objects* dialog generate a SQL command (see an example below). Use the *SQL* tab for review; revisit the *General* tab to modify the SQL command.
**Example**
The following is an example of the sql command generated by user selections in the *Move Objects* dialog:
.. image:: images/move_objects_sql.png
:alt: Move Objects dialog sql tab
The example shown demonstrates moving materialized views owned by Alice from tablespace *tbspace_01* to *tbspace_02*.
* Click the *Help* button (?) to access online help.
* Click the *OK* button to save work.
* Click the *Cancel* button to exit without saving work.