PyCharm 2023.1 Help

Data editor

Overview

The data editor provides a user interface for working with data. In the data editor, you can sort, filter, add, edit and remove the data as well as perform other, associated tasks.

Data Editor
  1. Toolbar.

  2. (For database objects data only.) Filtering and sorting queries pane.

  3. The database object data in a Table view.

In PyCharm, the data editor lets you work with a database object data and a query results set.

  • To work with a database object data, in the Database tool window, do one of the following:

    1. Double-click a database object.

    2. Select a database object and press F4.

    3. Select a database object and click the Edit Data icon (the Data Editor button) on the toolbar.

    4. Right-click an object and select Edit Data.

  • To work with a query results set, in a query console, do one of the following:

    1. Run a SQL query. The data editor opens in a Result tab of the Services tool window.

      For more information about a Result tab of a Services tool window, refer to Result tabs.

    2. Click the In-Editor Results button on the toolbar and run a query. The data editor opens in the query console in-editor results.

      For more information about the In-Editor Results, refer to In-Editor Results.

The default view mode is Table. In this mode, you can filter and sort data, edit value of the cells directly, and work with rows of the data table.

Main functions

Most of the available functions are accessed by means of controls on the toolbar, context menu commands for the data cells, and associated keyboard shortcuts.

Toolbar controls

Item

Tooltip and shortcut

Description

First page, Previous page, the Change page size button, Next page, Last page

First Page,

Previous Page Control+Alt+ArrowUp,

Change page size,

Next Page Control+Alt+ArrowDown,

Last Page

Use navigation icons and corresponding commands for switching between pages that show the table data and change the page size.

A number of rows that you see on the toolbar are referred to as a result set page. If this number is less than the number of rows in the table, only a subset of all the rows is shown at a time. If all the rows are currently shown, navigation icons and the corresponding commands are inactive. You can see the limit between the navigation buttons. You can change it here by clicking and selecting the necessary limit or in settings.

  • First page: jump to the first page of results.

  • Previous page: go to the previous page of results.

  • Next page: go to the next page of results.

  • Last page: jump to the last page of results.

To change the size of a result set page, click the Change page size button and select the size. Alternatively, open settings (Control+Alt+S) and navigate to Tools | Database | Data Editor and Viewer. In the Limit page size to field, type a new size of a result set page. Alternatively, to disable the page size restriction, clear the Limit page size to checkbox.

Reload page

Reload Page

Control+F5

Reload data for the table view to synchronize the data that you see in the editor with the contents of the database. Also, use the Reload Page button when you want to apply a new page size limit setting after its change.

Cancel Query

Cancel Running Statements

Control+F2

Terminate execution of the current statement or statements.

Add Row

Add Row

Alt+Insert

Add a row to the table.

To save a new row, click Submit the Submit button.

For more information about working with rows, see Tables.

Delete Row

Delete Row

Control+Y

Delete the selected row or rows.

To select multiple rows, click numbers in the gutter. Also, you can press Control and click the necessary rows.

the Revert Selected button

Revert Selected

Control+Alt+Z

Revert changes that you made to a cell value. You can select a scope of different cells and revert values in this scope.

For more information about reverting changes, see Submit changes to a database.

the Preview pending changes button

Preview Pending Changes

Preview DML of changes that you made to the table.

Preview pending changes

the Submit button

Submit

Control+Enter

Submit local changes to the database server. See Submit changes to a database.

Transaction mode

Transaction Mode

and

Transaction Isolation

Select the isolation level for database transactions and the way the transactions are committed.

  • Auto: the current transaction is committed automatically when you submit your local changes to the database server.

  • Manual: the changes submitted to the database server are accumulated in a transaction that can either be committed or rolled back explicitly by means of the Commit (Commit button) or Rollback (Rollback button) buttons on the toolbar.

For more information about database transaction modes and isolation, refer to Submit changes to a database.

the Submit and Commit button

Submit and CommitControl+Alt+Shift+Enter

Submit and commit the current transaction. This button is available only for the manual transaction mode. See also, transaction mode and isolation.

Rollback button

Roll Back

Roll back changes. This button is available only for the manual transaction mode. See also, transaction modes and isolation.

Go to DDL

Go to DDL

Open DDL of the object in the editor.

Open DDL of the object in the editor

the Find on Current Page button

Find on Current Page

Control+F

Opens a search field for the current page of results.

Data Extractor

Data Extractors

Select an output format for your data.

Also, you can configure the following options:

  • Skip Computed Columns: do not include virtual columns that are not physically stored in the table (for example, the identity column).

  • Skip Generated Columns: for INSERT and UPDATE statements, do not include auto-increment fields when copying or saving data.

  • Configure CSV Formats: open the CSV Formats dialog where you can manage your delimiter-separated values formats (for example, CSV, TSV).

  • Go To Scripts Directory: open a directory with scripts that convert table data into different output formats.

Export Data

Export Data

Export the table data to the clipboard or save to a file.

the Export button

Copy to Database

Copy the data to another table, schema or database. Select the target schema (a new table will be created) or table (the data will be added to the selected table). In the dialog that opens, specify the data mapping info and the settings for the target table.

Compare with

Compare Data

Compare the current table with a table from the list.

For more information about comparing tables, see Compare table data.

the View as button

View as

Select the mode for browsing and editing table data.

  • Transpose: viewing mode in which rows and columns are interchanged. You can combine this checkbox with other viewing modes.

    To make this mode a default for tables and views, open settings by pressing Control+Alt+S and navigate to Tools | Database | Data Views and select the Automatically transpose tables. When this option is enabled, query results are not transposed.

  • Table: the default viewing mode of table data. Data in a table is stored in a cell that is an intersection of a vertical column and horizontal row.

  • Tree: viewing mode in which data is displayed in the key-value table with the possibility to expand the key cell if it contains children nodes. Data from the expanded children node is distributed between key and value columns. You might consider using this mode to work with JSON and array data.

  • Text: viewing mode in which data is displayed as a text.

For more information on viewing data, refer to View data.

Show Options Menu

Show Options Menu

The Show Options Menu list includes the following options:

  • Show Geo Viewer: enable a graphic viewer to explore geospatial data in your database.

    For more information about the Geo viewer, refer to Using Geo viewer for geographical data in PostgreSQL.

  • Show Value Editor: open a separate editor where you can edit data that is stored in the cell.

    For more information about the editor, refer to Value editor.

  • Show Aggregate View: open the aggregate view where you can select values of multiple cells and get a single summary value.

    For more information about the view, refer to Aggregate view.

  • Sort via ORDER BY: sort data on a database level. The Sort via ORDER BY option is available only for tables in the data editor but not for table result sets in the Services tool window.

    If the Sort via ORDER BY option is on, data for the whole table is sorted according to the corresponding database system.

    Sort via ORDER BY is on

    Do not turn this option on if you want to keep interactions with the database to a minimum. For example, when the table is large or the database connection is slow. If you want to use sorting on the client side, clear the Sort via ORDER BY checkbox.

    If this option is off, the data is sorted locally and only for the rows that are currently shown.

    Sort via ORDER BY is off

    You can define which sorting method to use as the default for tables. You can select between Sort via ORDER BY or client-side. The client-side sorting does not run any new queries and sorts only the current page.

    To configure the settings, open settings by pressing Control+Alt+S and navigate to Tools | Database | Data Editor and Viewer. In the Data Sorting section, select or clear the Sort via ORDER BY checkbox. When this option is on, data for the whole table is sorted according to the corresponding database system.

    For more information about sorting data, refer to S.

  • Show Filter: show or hide the filter box.

  • Paste Format: select how you want to treat the text from the clipboard on paste.

  • Reset View: restore the initial table view if you customized the table view before (for example, hidden columns or sorted data).

  • View Query: view the query that generated the table.

  • Copy Query to Console: copy the query that generated the table to query console.

  • Open Data View Settings...: open the Data Editor and Viewer section in settings, where you can define how table data are shown and modified in your query consoles and data editors.

    For more information about the Data Editor and Viewer settings section, refer to Data Editor and Viewer.

Context menu

Action

Shortcut

Description

Edit

F2

Edit a value in the selected cell or cells. Alternatively, you can double-click the cell and start typing a value. The Edit command is unavailable for read-only values.

  • To open the auto-completion list, press Control+Space.

  • To confirm your changes, press Enter.

  • To cancel editing, press Escape.

For more information about editing cells, see Cells.

App general expand component Open in Value Editor

Shift+Enter

Open in a separate value editor where you can edit data that is stored in the cell.

For more information about the editor, refer to Value editor.

App general expand component Show Aggregate View

Open the aggregate view where you can select values of multiple cells and get a single summary value.

For more information about the view, refer to Aggregate view.

the Revert Selected button Revert Selected

Control+Alt+Z

Revert changes that you made to a cell value. You can select a scope of different cells and revert values in this scope.

For more information about reverting changes, see Submit changes to a database.

Set Highlighting Language

Select a language that the IDE should use to highlight data in a cell.

Change Display Type

Select how the IDE should display binary data in the column. 16-byte data is displayed as UUID by default.

Set DEFAULT

Control+Alt+D

Set the current cell value to the default value or the value that you specified for the column.

For more information about how to view or set a default value, see Manage default and NULL values for a cell.

Set NULL

Control+Alt+N

Set the current cell value to NULL.

For more information about how to allow a NULL value, see Manage default and NULL values for a cell.

Load File…

Load a file into the field.

Save LOB…

For the cells that contain a binary large object (LOB). Save content of a cell into a file.

App actions copy Copy

Control+C

Copy selection to the clipboard.

App actions copy Copy Aggregation Result (SUM)

Copy a summary value for a range of cells. By default, PyCharm copies the SUM aggregation result. To change the default, right-click the status bar and ensure that the Aggregator option is selected. Click the aggregator widget on the status bar and select the aggregator to use as default.

grid.aggregator.widget.display.name

App actions menu paste Paste

Control+V

Paste the contents of clipboard into the table.

App general add Add Row

Add a row to the end of a table.

App general remove Delete Row

Alt+Delete

Delete selected rows.

App actions copy Clone Row

Create a duplicate of the selected row and adds the duplicate to the end of a table.

Quick Documentation

Control+Q

Show information about selected objects. For different database objects, Quick Documentation shows corresponding information. For example, for a group of cells, you will see a summary for the selection. You can preview it in a regular or in a transposed view and also see the related records by their foreign keys.

Go To | Navigation Bar

Jump to a navigation bar.

Go To | Database

Open the selected object in the Database tool window.

Go To | Related Symbol

Navigate to one of the related objects.

Go To | DDL

Open an object definition (DDL).

Go To | Row…

Control+G

Jump to a specified row.

In the Go to Row dialog, specify the column and row number (use the column:row pattern).

Go To | All Related Rows

F4

Jump to a related record.

The command options are a combination of those for Go To | Referenced Rows and Go To | Referencing Rows. Read more about related data in Navigate between related data.

All Related Rows

The command is not available if there are no related records.

Go To | Referenced Rows

Control+B

Switch to a record that the current record references. If more than one record is referenced, select the target record in the popup that appears.

Read more about related data in Navigate between related data.

The command is not available if there are no referenced records.

Go To | Referencing Rows

Alt+F7

Use this command or shortcut to see the records that reference the current record. Read more about related data in Navigate between related data. In the popup that appears there are two categories for the target records:

  • First Referencing Row: all the rows in the corresponding table are shown, and the first of the rows that references the current row is selected.

  • Referencing Rows Only: only the rows that reference the current row are shown.

The command is not available if there are no records that reference the current one.

Filter by

Select a filter that you want to a column.

App actions search Full-Text Search…

Control+Alt+Shift+F

Open a search window where you can search for data in your database or a group of databases. For more information about full-text search, see Full-text search in databases.

Search for data in databases

App actions download Export Table to Clipboard

Copy the whole table to the clipboard. This action does not depend on Limit page size to setting.

Switch Session (your_current_session_name)

Open a window to select another session or create a new one. For more information about sessions, see Manage connection sessions.

Last modified: 21 June 2023