mirror of
https://github.com/pgadmin-org/pgadmin4.git
synced 2025-02-12 00:16:09 -06:00
710d520631
When a query is run in the Query Tool, check if the source of the columns can be identified as being from a single table, and that we have all columns that make up the primary key. If so, consider the resultset to be editable and allow the user to edit data and add/remove rows in the grid. Changes to data are saved using SAVEPOINTs as part of any transaction that's in progress, and rolled back if there are integrity violations, without otherwise affecting the ongoing transaction. Implemented by Yosry Muhammad as a Google Summer of Code project.
141 lines
5.3 KiB
ReStructuredText
141 lines
5.3 KiB
ReStructuredText
.. _editgrid:
|
|
|
|
|
|
***********************
|
|
`View/Edit Data`:index:
|
|
***********************
|
|
|
|
To view or modify data, right click on a table or view name in the *Browser*
|
|
tree control. When the context menu opens, use the *View/Edit Data* menu to
|
|
specify the number of rows you would like to display in the editor panel.
|
|
|
|
.. image:: images/editgrid.png
|
|
:alt: Edit grid window
|
|
:align: center
|
|
|
|
To modify the content of a table, each row in the table must be uniquely
|
|
identifiable. If the table definition does not include an OID or a primary key,
|
|
the displayed data is read only. Note that views cannot be edited; updatable
|
|
views (using rules) are not supported.
|
|
|
|
The editor features a toolbar that allows quick access to frequently used
|
|
options, and a work environment divided into two panels:
|
|
|
|
* The upper panel displays the SQL command that was used to select the content
|
|
displayed in the lower panel.
|
|
* The lower panel (the Data Grid) displays the data selected from the table or
|
|
view.
|
|
|
|
The View/Edit Data Toolbar
|
|
**************************
|
|
|
|
The :ref:`Query Tool <query_tool>` and :ref:`View/Edit Data <editgrid>` tools
|
|
are actually different operating modes of the same tool. Some controls will be
|
|
disabled in either mode. Please see
|
|
:ref:`The Query Tool Toolbar <query_tool_toolbar>` for a description of the
|
|
available controls.
|
|
|
|
The Data Grid
|
|
*************
|
|
|
|
The top row of the data grid displays the name of each column, the data type,
|
|
and if applicable, the number of characters allowed. A column that is part of
|
|
the primary key will additionally be marked with [PK].
|
|
|
|
.. _modifying-data-grid:
|
|
|
|
To modify the displayed data:
|
|
|
|
* To change a numeric value within the grid, double-click the value to select
|
|
the field. Modify the content in the square in which it is displayed.
|
|
* To change a non-numeric value within the grid, double-click the content to
|
|
access the edit bubble. After modifying the contentof the edit bubble, click
|
|
the *Ok* button to display your changes in the data grid, or *Cancel* to
|
|
exit the edit bubble without saving.
|
|
|
|
To enter a newline character, click Ctrl-Enter or Shift-Enter. Newline
|
|
formatting is only displayed when the field content is accessed via an edit
|
|
bubble.
|
|
|
|
To add a new row to the table, enter data into the last (unnumbered) row of the
|
|
table. As soon as you store the data, the row is assigned a row number, and a
|
|
fresh empty line is added to the data grid.
|
|
|
|
To write a SQL NULL to the table, simply leave the field empty. When you store
|
|
the new row, the will server fill in the default value for that column. If you
|
|
store a change to an existing row, the value NULL will explicitly be written.
|
|
|
|
To write an empty string to the table, enter the special string '' (two single
|
|
quotes) in the field. If you want to write a string containing solely two single
|
|
quotes to the table, you need to escape these quotes, by typing \'\'
|
|
|
|
To delete a row, press the *Delete* toolbar button. A popup will open, asking
|
|
you to confirm the deletion.
|
|
|
|
To commit the changes to the server, select the *Save Data* toolbar button.
|
|
|
|
**Geometry Data Viewer**
|
|
|
|
If PostGIS is installed, you can view GIS objects in a map by selecting row(s)
|
|
and clicking the 'View Geometry' button in the column. If no rows are selected,
|
|
the entire data set will be rendered:
|
|
|
|
.. image:: images/geometry_viewer.png
|
|
:alt: Geometry Viewer Button
|
|
:align: center
|
|
|
|
You can adjust the layout by dragging the title of the panel. To view the
|
|
properties of the geometries directly in map, just click the specific geometry:
|
|
|
|
.. image:: images/geometry_viewer_property_table.png
|
|
:alt: Geometry Viewer Property Table
|
|
:align: center
|
|
|
|
.. note::
|
|
|
|
- *Supported data types:* The Geometry Viewer supports 2D and 3DM geometries in
|
|
EWKB format including `Point, LineString, Polygon MultiPoint, MultiLineString,
|
|
MultiPolygon and GeometryCollection`.
|
|
|
|
- *SRIDs:* If there are geometries with different SRIDs in the same column, the
|
|
viewer will render geometries with the same SRID in the map. If SRID=4326 the
|
|
OSM tile layer will be added into the map.
|
|
|
|
- *Data size:* For performance reasons, the viewer will render no more than
|
|
100000 geometries, totaling up to 20MB.
|
|
|
|
- *Internet access:* An internet connection is required for the Geometry Viewer
|
|
to function correctly.
|
|
|
|
Sort/Filter options dialog
|
|
**************************
|
|
|
|
You can access *Sort/Filter options dialog* by clicking on Sort/Filter button.
|
|
This allows you to specify an SQL Filter to limit the data displayed and data
|
|
sorting options in the edit grid window:
|
|
|
|
.. image:: images/editgrid_filter_dialog.png
|
|
:alt: Edit grid filter dialog window
|
|
:align: center
|
|
|
|
* Use *SQL Filter* to provide SQL filtering criteria. These will be added to
|
|
the "WHERE" clause of the query used to retrieve the data. For example,
|
|
you might enter:
|
|
|
|
.. code-block:: sql
|
|
|
|
id > 25 AND created > '2018-01-01'
|
|
|
|
* Use *Data Sorting* to sort the data in the output grid
|
|
|
|
To add new column(s) in data sorting grid, click on the [+] icon.
|
|
|
|
* Use the drop-down *Column* to select the column you want to sort.
|
|
* Use the drop-down *Order* to select the sort order for the column.
|
|
|
|
To delete a row from the grid, click the trash icon.
|
|
|
|
* Click the *Help* button (?) to access online help.
|
|
* Click the *Ok* button to save work.
|
|
* Click the *Close* button to discard current changes and close the dialog.
|