2019-03-07 08:26:56 -06:00
.. _tree_control:
2016-06-07 03:04:58 -05:00
2018-06-15 03:14:12 -05:00
***** ***** ***** ***** ***** *** *
2019-03-07 08:26:56 -06:00
`Tree Control` :index:
2018-06-15 03:14:12 -05:00
***** ***** ***** ***** ***** *** *
2016-06-07 03:04:58 -05:00
2018-01-11 10:58:30 -06:00
The left pane of the main window displays a tree control (the *pgAdmin* tree control) that provides access to the objects that reside on a server.
2016-06-07 03:04:58 -05:00
.. image :: /images/main_left_pane.png
2018-01-11 10:58:30 -06:00
:alt: Browser tree panel
2016-06-07 03:04:58 -05:00
2018-01-11 10:58:30 -06:00
You can expand nodes in the tree control to view the database objects that reside on a selected server. The tree control expands to display a hierarchical view:
2016-06-07 03:04:58 -05:00
2018-01-11 10:58:30 -06:00
* Use the plus sign (+) to the left of a node to expand a segment of the tree control.
* Click the minus sign (-) to the left of a node to close that node.
2016-06-07 03:04:58 -05:00
2018-01-11 10:58:30 -06:00
Access context-sensitive menus by right-clicking on a node of the tree control to perform common tasks. Menus display options that include one or more of the following selections (options appear in alphabetical order):
2016-06-07 03:04:58 -05:00
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| Option | Action |
+===========================+===========================================================================================================================+
| *Add named restore point* | Click to create and enter the name of a restore point. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Backup...* | Click to open the :ref: `Backup... <backup_dialog>` dialog to backup database objects. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Backup Globals...* | Click to open the :ref: `Backup Globals... <backup_globals_dialog>` dialog to backup cluster objects. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Backup Server...* | Click to open the :ref: `Backup Server... <backup_server_dialog>` dialog to backup a server. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Connect Server...* | Click to open the :ref: `Connect to Server <connect_to_server>` dialog to establish a connection with a server. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Create* | Click to access a context menu that provides context-sensitive selections. |
| | Your selection opens a *Create* dialog for creating a new object. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
2016-06-21 03:06:44 -05:00
| *CREATE Script* | Click to open the :ref: `Query tool <query_tool>` to edit or view the CREATE script. |
2016-06-07 03:04:58 -05:00
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Debugging* | Click through to open the :ref: `Debug <debugger>` tool or to select *Set breakpoint* to stop or pause a script execution. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Delete/Drop* | Click to delete the currently selected object from the server. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Disconnect Database...* | Click to terminate a database connection. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Disconnect Server...* | Click to refresh the currently selected object. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Drop Cascade* | Click to delete the currently selected object and all dependent objects from the server. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Debugging* | Click to access the :ref: `Debugger <debugger>` tool. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Grant Wizard* | Click to access the :ref: `Grant Wizard <grant_wizard>` tool. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Maintenance...* | Click to open the :ref: `Maintenance... <maintenance_dialog>` dialog to VACUUM, ANALYZE, REINDEX, or CLUSTER. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
2018-01-11 10:58:30 -06:00
| *Properties...* | Click to review or modify the currently selected object's properties. |
2016-06-07 03:04:58 -05:00
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Refresh...* | Click to refresh the currently selected object. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Reload Configuration...* | Click to update configuration files without restarting the server. |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *Restore...* | Click to access the :ref: `Restore <restore_dialog>` dialog to restore database files from a backup. |
2018-01-11 10:58:30 -06:00
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
| *View Data* | Use the *View Data* option to access the data stored in a selected table with the *Data Output* tab of the *Query Tool* . |
2016-06-07 03:04:58 -05:00
+---------------------------+---------------------------------------------------------------------------------------------------------------------------+
The context-sensitive menus associated with *Tables* and nested *Table* nodes provides additional display options (options appear in alphabetical order):
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| Option | Action |
+=========================+==============================================================================================================================+
| *Import/Export...* | Click open the :ref: `Import/Export... <import_export_data>` dialog to import data to or export data from the selected table. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *Reset Statistics* | Click to reset statistics for the selected table. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
2016-06-21 03:06:44 -05:00
| *Scripts* | Click to open the :ref: `Query tool <query_tool>` to edit or view the selected script from the flyout menu. |
2016-06-07 03:04:58 -05:00
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *Truncate* | Click to remove all rows from a table. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *Truncate Cascade* | Click to remove all rows from a table and its child tables. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *View First 100 Rows* | Click to access a data grid that displays the first 100 rows of the selected table. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *View Last 100 Rows* | Click to access a data grid that displays the last 100 rows of the selected table. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *View All Rows* | Click to access a a data grid that displays all rows of the selected table. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+
| *View Filtered Rows...* | Click to access the *Data Filter* popup to apply a filter to a set of data. |
+-------------------------+------------------------------------------------------------------------------------------------------------------------------+