Aqua 2024.2 Help

Cells

Quick documentation

The quick documentation provides details about values in the selected cell or cells. For example, if a cell contains a long text, you will see the whole text. Also, you can see records that are referenced in the current record as well as the records that reference the current one.

Object

Quick documentation view

Long text

If a cell contains a long text, you will see the whole text.

Quick documentation view for long texts

Records

The quick documentation view for records displays records that are referenced in the current record and records that reference the current one.

You can switch to a transposed mode. In the transposed view, rows and columns are interchanged.

To switch to the transposed mode, click Transposed mode. For more information about the transposed view in tables, refer to Transpose a table.

Quick documentation view for an image
Transposed view for records

Grid floating toolbar

When you select a grid cell, depending on the data type and contents, Aqua shows a floating toolbar with actions for working with cell contents.

Consider the following example of default actions:

  • the Related Rows icon: navigate to related rows.

    Default action in floating toolbar for primary keys
  • the Open URL icon: open URLs in OS default web browser.

    Default action in floating toolbar for URLs
  • the Open File URI icon: open file URIs in OS default file browser.

    Default action in floating toolbar for file URIs

Toggle the toolbar

  1. Press Ctrl+Alt+S to open settings and then select Tools | Database.

  2. In the Data Editor and Viewer section, select the Disable Grid Floating Toolbar option to hide the toolbar. Deselect the option to enable the toolbar.

  3. Apply the changes and close the dialog.

Customize the toolbar

  1. Press Ctrl+Alt+S to open settings and then select Appearance & Behavior | Menus and Toolbars.

    Alternatively, click More on the toolbar and select Customize Toolbar.

  2. Add or remove actions under Grid Floating Toolbar.

    For more information, refer to Menus and toolbars.

  3. Apply the changes and close the dialog.

Productivity tips

Manage default and NULL values for a cell

When a new row is created and no values are specified for some cells, those cells are filled with their respective default Ctrl+Alt+D or NULL (Ctrl+Alt+N) values.

When you set default values for a cell, you can use corresponding actions from the context menu (Set DEFAULT and Set NULL).

  1. In the Database tool window ( View | Tool Windows | Database) , expand a data source tree.

  2. Right-click the table and select Modify Table Ctrl+F6.

  3. In the table structure tree, expand the columns node and double-click the column that you want to edit.

  4. In the Default Expression field, specify the default value of the cell in the column. To allow NULL values, clear the Not Null checkbox.

Edit multiple cell values simultaneously

  1. Select a range of cells that you want to edit.

  2. Start typing a new value. The changes are applied to all the selected cells.

  3. To confirm the value, press Enter. To cancel editing, press Escape.

  4. (Optional) Submit and commit your changes to the database.

Edit multiple cell values

Saving an LOB into a file

You can save a binary large object (BLOB or LOB) from a cell into a file.

  1. Right-click the cell that contains the LOB and select Save LOB.

  2. In the save dialog, specify the name and location of the file and click OK.

Saving an LOB into a file

Copy and paste cells between tables

You can copy and paste selected cells and ranges of cells – within the same table or from one table to another one.

Use value completion

You can use value completion to edit cells values.

Note that the completion is local, so its options are based on other values in the current column which are already loaded.

  1. Double-click the cell to start editing its value.

  2. (Optional) Enter the first letter.

  3. Press Ctrl+Space and select the value.

  4. (Optional) Submit and commit your changes to the database.

Submit and commit your changes to the database

Depending on the current transaction mode, you can submit and commit your changes to the database by doing one of the following:

  1. Tx:Auto mode: click The Submit button Submit on the toolbar. The changes will be committed to the database automatically.

  2. Tx:Manual mode: click The Submit button Submit to submit your changes and The Commit button Submit and Commit to commit the submitted changes to the database.

For more information about committing changes to the database, refer to the Submit changes to a database topic.

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
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 Ctrl+Space.

  • To confirm your changes, press Enter.

  • To cancel editing, press Escape.

the Open in Value Editor icon 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.

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

Ctrl+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, 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

Ctrl+Alt+D

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

Ctrl+Alt+N

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

Ctrl+C

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

Ctrl+V

Paste the contents of clipboard into the table.

Add Row

Add a row to the end of a table.

Delete Row

Alt+Delete

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

Ctrl+G

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 page of settings  Ctrl+Alt+S.

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 page of settings  Ctrl+Alt+S.

Filter by

Select a filter that you want to a column.

Full-Text Search

Ctrl+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, 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 (your_current_session_name)

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

Quick Documentation

Ctrl+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.

Last modified: 11 October 2024