The database explorer provides an SQL client and a database objects browser for any database contained in any managed database server.

1 Databases view

For a given database server, the Databses node retrieves the catalog names available in this database. The results are ordered by catalog name. Clicking on any database, a connection will be stablished and the objects tree will be shown.

To establish a connection to a database, the credentials being used must match the database system permisions.

2 SQL client

SQL Command Line Interface (CLI) allows users to run SQL statements on any selected database. The interface is divided in two areas, the editor section on top and the log/results section on bottom.

  • Multiple statements can be executed.
  • Statement separator is semicolon
  • Statements will be executed sequentially, and execution will stop as soon as an error occurs.
  • Execution will apply for all text in editor or selected text if selection exists.
  • Statements are executed using a connection pool.
  • A single connection from pool is used per an execution block.
  • Transaction control is set to autocommit by default.
  • Transaction control statements can be used in statements.
  • When execution finishes with an open transaction with no explicit commit, rollback is done.

2.1 Editor Actions

  • : Run SQL statements
  • : Stop ongoing execution of SQL statements
  • : Open SQL file containing statements
  • : Save current statements in file
  • : Save current statements in file with custom filename
  • : Open history view with last and favorite querys
  • : Undo the most recent editor action
  • : Redo the most recent editor action
  • : Cut text
  • : Copy text
  • : Paste text
  • : Increase font size
  • : Decrease font size

2.2 Results

The results of executions are displayed in tabs. The first tab is always a logs tab, which shows a log of previous executions in the SQL Editor.

2.2.1 Data tabs

  • : Reloads data shown in panel, running the SQL statement that produced the output again.
  • Status:
    1. : Query is currently executing.
    2. : Retrieving data from server.
    3. : Idle.
  • : Shows SQL used to retrieve panel data.
  • : Reloads panel data every selected seconds.
  • : Exports data in panel to file.
  • : Resizes table columns to fit content. Typically only activated when large datasets are retrieved, because the application doesn't apply automatic resizing of column width.
  • : Toggles view between the chart and the data table. This option is only enabled for special objects.
  • : Opens the query by example tool, used to filter the SQL rows returned. This option is only enabled on data for a given table (Database->Table->Data).
  • : Access to predefined filters. This option is only enabled for special objects.

2.2.2 Results Footer

For each SQL statement, a tab will be created for each statement returning data. The tab name will also be the name of the SQL statement's main table and the number of rows fetched.

  1. Navigation buttons.
  2. Limits the number of rows displayed in the tab. Displaying a large result set may result in decreased performance. The geen icon indicates all rows have been fetched. The scroll icon indicates the data has been limited.
  3. Threshold for text length overflow. Overflowed text cells will be displayed in purple.
  4. Execution and fetch time (in seconds)
  5. Current number of rows and columns in the grid
  6. The numerical range between the first and last visible row(s) in the grid

3 Objects explorer

The database objects explorer shows a hierachical view of database objects.

3.1 Schemas

In a relational database, the schema defines the tables, fields, relationships, views, indexes, packages, procedures, functions, triggers, types, sequences, views, synonyms and other elements.

The Schemas node shows the database defined schemas (owner) and the objects that belongs to it.

The general view for Tables, Views, etc, contains the same information but ignoring schema ownership.

3.2 Tables

The Tables node retrieves a description of the tables available in the given catalog. Only table descriptions matching the catalog, schema, table name and type criteria are returned. They are ordered by TABLE_TYPE, TABLE_CAT, TABLE_SCHEM and TABLE_NAME.

3.2.1 Columns

Retrieves a description of table columns available in the table.

3.2.2 Data

Shows first (1000) rows of table data

View row data

Double click on a row to open a detailed view

Query by example

When looking on table data, the SQL editor toolbar icon will be enabled. Click on it to open the QBE form.

3.2.3 Indexes

Retrieves a description of the given table's indices and statistics. They are ordered by NON_UNIQUE, TYPE, INDEX_NAME, and ORDINAL_POSITION.

3.2.4 Primary key

Retrieves a description of the given table's primary key columns. They are ordered by COLUMN_NAME.

3.2.5 Privileges

Retrieves a description of the access rights for the table. Note that a table privilege applies to one or more columns in the table. It would be wrong to assume that this privilege applies to all columns (this may be true for some systems but is not true for all.)

3.2.6 ER diagram

3.2.7 Constraints

3.2.8 Triggers

Shows the triggers associated on selected table (detailed for events, like INSERT, DELETE or UPDATE).

3.2.9 Version columns

Retrieves a description of a table's columns that are automatically updated when any value in a row is updated.

3.2.10 Table information

The table information view shows specific database information for selected table including a summary overview, the storage usage, the active locks, the activity profile and a storage estimations calculator.

Summary

The summary shows information for table profile, storage and I/O.

Storage

Shows the table storage monitor. The monitor will show all storage objects (table, indexes) related with the table, it's primary location and information related to extent size, pages allocated and usage.

Selecting on any object, you can see the Extend details and the Storage ditributon by device.

You can also launch the storage optimization wizard to Compress, Uncompress, Repack, Shrink or Defragement the table.

Locks

Shows current table locks

Profile

Shows table activity profile.

Estimations

Shows the table/index sizing estimation wizard.

3.3 Synonyms

The Synonyms node may not appear if no synonyms are present in database.

3.4 System tables

Shows system tables (and its data) from selected database

3.5 Views

Shows views (and its data content) on selected database

3.6 Functions

Retrieves a description of the system and user functions available in the given catalog. Only system and user function descriptions matching the schema and function name criteria are returned. They are ordered by FUNCTION_CAT, FUNCTION_SCHEM, FUNCTION_NAME and SPECIFIC_ NAME.

3.7 System functions

Shows system functions (and function body content) on selected database.

3.8 Procedures

Retrieves a description of the stored procedures available in the given catalog. Only procedure descriptions matching the schema and procedure name criteria are returned. They are ordered by PROCEDURE_CAT, PROCEDURE_SCHEM, PROCEDURE_NAME and SPECIFIC_ NAME.

3.9 System procedures

Shows system procedures (and procedure body content) on selected database.

3.10 Triggers

Shows database triggers (and trigger body content) on selected database.

3.11 Attributes

Retrieves a description of the given attribute of the given type for a user-defined type (UDT) that is available in the given schema and catalog. Descriptions are returned only for attributes of UDTs matching the catalog, schema, type, and attribute name criteria. They are ordered by TYPE_CAT, TYPE_SCHEM, TYPE_NAME and ORDINAL_POSITION. This description does not contain inherited attributes.

3.12 Privileges

Shows database user privileges on selected database.

3.13 Sequences

Shows the sequences currently defined on selected database.

3.14 Data types

Shows the Disctinct, Opaque and UDT (used defined types) object types defined on selected database.

3.15 ER diagram

The entity relationship graph automatically renders all referential integrity constraints using a directed graph (also called digraph) representation. The table nodes and relations are layed out automatically and graph scale is adjusted to fit available display are. A set of options are available from the toolbar including:

  • Toggle show constraint names in edges
  • Export graph to PNG
  • Zoom out
  • Zoom in
  • Zoom 1:1
  • Zoom to fit
  • Select deep level (only on ER for tables)
  • Toggle view for Columns, Columns and data type, Primary keys only, Only table names

You can double click on a table to get it's detailed information.