Aqua
 
2024.3
Shortcuts: Windows
Get Aqua
  1. Database Tools and SQL
  2. Data editor and viewer

Data editor and viewer

Last modified: 27 December 2024

Enable the Database Tools and SQL plugin

This functionality relies on the Database Tools and SQL plugin, which is bundled and enabled in Aqua by default. If the relevant features are not available, make sure that you did not disable the plugin.

  1. Press CtrlAlt0S to open settings and then select Plugins.

  2. Open the Installed tab, find the Database Tools and SQL plugin, and select the checkbox next to the plugin name.

Overview

The data editor and viewer, or 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.

In Aqua, the data editor and viewer lets you work with database object data, query results sets, and also User files data.

Data editor tab

  1. Toolbar.

  2. Filtering and sorting queries pane.

  3. The database object data in a Table view.

For more information about Database tool window, refer to Database tool window.

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.

Open database object data

To open database object data in data editor, in the Database tool window, do one of the following:

  • Double-click a database object.

  • Select a database object and press F4.

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

  • Right-click an object and select Edit Data.

View query results set

To view a query results set in data editor, in a query console, do one of the following:

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

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

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

View user files data as a table

  • For tabular data user files of supported formats, do the following:

    • In the Project tool window (View | Tool Windows | Project) , click the tabular data file that you want to view as a table.

    For such files, the table view is read-only.

    Contents of an Excel file are displayed in the data editor

  • For DSV user files, do the following:

    1. In the Project tool window (View | Tool Windows | Project) , click the DSV file that you want to view and edit as a table.

    2. Right-click inside a delimited text file and then click Edit as Table. Alternatively, you can click the Edit as Table icon in the editor.

    3. In the Configure CSV Format for <file_name> dialog that opens, specify format settings and click OK.

      The dialog has three predefined formats (CSV, TSV, and Pipe-separated) and lets you create a custom format. For example, you may require comma-separated values with semicolons as row separators.

      Once you confirm the format settings, the Data tab will present data in a table format correspondingly. If you want to use different format settings, repeat the previous procedure and open the data editor again.

    tip

    If you want to edit only part of the data, select the necessary fragment inside the file.

Close data editor

  • To close data editor, click the Close icon Close next to the corresponding tab title.

Work with data

View data

You can browse and edit data in three modes: Table, Tree, Text, and Transpose. In the Table mode, you can also transpose the view. Use the value editor to view and edit the contents of a separate cell.

For full information on data view modes and other features, refer to View data.

The transposed table viewing mode

Compare data

Compare the data of two database objects. For comparison, you can define how many columns should differ to consider two columns equal. You can also select to ignore the extra column in either one of the objects.

For full information, refer to Compare the data of database objects.

Compare table data tolerance equals to one

Sort data

You can sort data by clicking a column's header, or by entering a sorting query into the corresponding field. By default, each time you sort data, Aqua sends a new ORDER BY query to the database. You can also change the setting and sort data on the client side.

For more information about sorting data, refer to the Sort data topic.

Filter data

Use one of the following ways to filter data:

  • Specify filtering conditions.

  • Run a search on the table.

  • Enter a filtering query into the corresponding field.

For more information about filtering data, refer to the Filter data topic.

WHERE and ORDER BY fields for sorting

Export data

Aqua uses data extractors to export data in various formats to a file or the clipboard. Each time you export or copy data, the copied data format is defined by the selected data extractor.

Data extractor list on the data editor toolbar

You can use a built-in data extractor, configure a custom extractor based on CSV or DSV format, and create a custom data extractor using a provided API.

The last selected extractor becomes the default one for newly opened editor tabs. For MongoDB, the default extractor is always JSON.

For more information about data extractors, refer to the corresponding page.

For more information about exporting data in Aqua, refer to Export data.

Rows

Manipulate the rows by adding, deleting, cloning them, and so on. You can also navigate between related rows, between subsets of rows, or go to a specified row.

For full information on these and other features, refer to Rows.

Reference

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

Toolbar controls

Icon

Action and shortcut

Description

First page

Previous page

the Change page size button

Next page

Last page

First Page

Previous Page CtrlAlt0↑

Change page size

Next Page CtrlAlt0↓

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 (CtrlAlt0S) 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.

the Reload Page icon

Reload Page

CtrlF5

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.

the Update Interval icon

Update Interval

Select, pause, or disable update interval for the current table. You can also set a custom one.

the Cancel Running Statements icon

Cancel Running Statements

CtrlF2

Terminate execution of the current statement or statements.

the Add Row icon

Add Row

AltInsert

Add a row to the table.

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

For more information about working with rows, refer to Tables.

the Delete Row icon

Delete Row

Ctrl0Y

Delete the selected row or rows.

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

the Revert Selected button

Revert Selected

CtrlAlt0Z

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, refer to Submit changes to a database.

the Preview Pending Changes icon

Preview Pending Changes

Preview DML of changes that you made to the table.

the Submit button

Submit

CtrlEnter

Submit local changes to the database server. For more information about submitting and reverting changes, refer to 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 Submit and Commit (the Submit and Commit icon) or Roll Back (the Roll Back 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 icon

Submit and CommitCtrlAltShiftEnter

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

the Roll Back icon

Roll Back

(For the Manual transaction mode.) 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.

the Find on Current Page button

Find on Current Page

Ctrl0F

Opens a search field for the current page of results.

the Show Chart icon

Show Chart

Opens data visualization.

For more information about about charts, refer to Visualize data.

Data Extractor

Data Extractors

Select an output format for your data. For the list of available formats and full information about data extractors, refer to the Data extractors topic.

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.

For more information about data extractors, refer to the Data extractors topic.

the Export Data icon

Export Data

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

the Copy to Database icon

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.

the Compare Data icon

Compare Data

Compare the current table with a table from the list.

For more information about comparing tables, refer to Compare table data.

the View as icon

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 CtrlAlt0S and navigate to Tools | Database | Data Editor and Viewer. . From the Automatically transpose tables list, select Always. 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 about viewing data, refer to View data.

the Show Options Menu icon

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 the database side by sending a new ORDER BY query to the database. The client-side sorting does not run any new queries and sorts only the current page.

    note

    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.

    tip

    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 connection to your database is slow. If you want to use sorting on the client side, clear the Sort via ORDER BY checkbox.

    You can define which sorting method to use as the default for tables. To do that, open settings by pressing CtrlAlt0S and navigate to Tools | Database | Data Editor and Viewer. . In the Data Sorting section, select or clear the Sort via ORDER BY checkbox.

    For more information about sorting data, refer to Sort data.

  • 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

You can find all basic actions for working with cells under the context menu. To call the context menu, right-click the cell that you want to modify. The following table lists all the actions.

Context menu of a cell in data editor

Action

Shortcut

Description

Edit

Enter

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 CtrlSpace.

  • To confirm your changes, press Enter.

  • To cancel editing, press Esc.

For more information about editing cells, refer to Cells.

the Open in Value Editor icon Open in Value Editor

ShiftEnter

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.

the Show Aggregate View icon Show Aggregate View

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

the Revert Selected button Revert Selected

CtrlAlt0Z

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, refer to 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

CtrlAlt0D

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

For more information about viewing or set a default value, refer to Manage default and NULL values for a cell.

Set NULL

CtrlAlt0N

Set the current cell value to NULL.

For more information about allowing a NULL value, refer to Manage default and NULL values for a cell.

Generate UUID

Generates the UUID for the selected 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.

the Copy icon Copy

Ctrl0C

Copy selection to the clipboard.

the Copy Aggregation Result (SUM) icon Copy Aggregation Result (SUM)

Copy a summary value for a range of cells. By default, Aqua 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.

the Paste icon Paste

Ctrl0V

Paste the contents of clipboard into the table.

Add Row

Add a row to the end of a table.

Delete Row

AltDelete

Delete selected rows.

Clone Row

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

Go To

Navigation Bar

Jump to a navigation bar.

Database

Open the selected object in the Database tool window.

Related Symbol

Navigate to one of the related objects.

DDL

Open an object definition (DDL).

Row

Ctrl0G

Jump to a specified row.

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

the Related Rows icon Related Rows

F4

Navigates to the related records:

  • Records that the current record references.

  • Records that reference the current record.

If more than one record is referenced or referencing the current one, select the target record in the popup that appears.

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

For more information about related data, refer to Navigate between related rows.

For more information about action behavior options, refer to Advanced Settings.

the Open URL icon Open URL

F4

Opens URL in OS default browser.

Requires the links opening URL Click Settings enabled in the Tools | Database | Data Editor and Viewer settings page  CtrlAlt0S.

the Open File icon Open File

F4

Open file URI in OS default file browser. For example, file:///Users/Username/image.png.

Requires the links opening URL Click Settings enabled in the Tools | Database | Data Editor and Viewer settings page  CtrlAlt0S.

Filter by

note

Available only for the database objects data, not for the query results set.

Select a filter that you want to a column.

Full-Text Search

CtrlAltShift0F

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, refer to Full-text search in databases.

Export Table to Clipboard

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

Switch Session

Open a window to select another session or create a new one. For more information about sessions, refer to Sessions.

Quick Documentation

Ctrl0Q

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.

See also

Reference

Concepts

Language and Framework-Specific Guidelines