Documentation 7.0
Aqua Data Studio 7.0
1. Installation
    1.1 Minimum Requirements
    1.2 Installing Aqua Data Studio in Windows OS
    1.3 Installing Aqua Data Studio in Linux OS
    1.4 Installing Aqua Data Studio in Mac OS
    1.5 First steps towards Configuring
    1.6 Character set and Internationalization
2. Server Registration
    2.1 Supported RDBMS Servers in ADS 7.0
    2.2 How to Register a Server in ADS 7.0
    2.3 How to Edit Server Properties
    2.4 How to Copy Server Configurations
    2.5 Troubleshoot Registrations
    2.6 Tips and Tricks
    2.6.1 How to Register a Server Clone
    2.6.2 Tab Coloring to Identify Servers
    2.6.3 Using Filter Options in Registration
    2.6.4 Using Advanced Properties
    2.6.5 Permissions in Server Registration
    2.6.6 Drag and Drop Features
    2.6.7 Navigating with Short cut Keys
    2.6.8 SQL Express 2005
    2.6.9 MSDE 2000
    2.6.10 PostgreSQL SSL
    2.7. JDBC Drivers and Server Registration
        2.7.1 Oracle 8i JDBC Drivers
        2.7.2 Oracle 9i JDBC Drivers
        2.7.3 Oracle 10g JDBC Drivers
        2.7.4 Oracle 11g JDBC Drivers
        2.7.5 DB2 iSeries JDBC Drivers
        2.7.6 DB2 7.2 JDBC Drivers
        2.7.7 DB2 UDB 8.1 and DB2 UDB 8.2
        2.7.8 DB2 UDB 9.0 and DB2 UDB 9.5
        2.7.9 SQL Server JDBC Drivers
        2.7.10 Sybase ASE JDBC Drivers
        2.7.11 Sybase Anywhere JDBC Drivers
        2.7.12 Sybase IQ JDBC Drivers
        2.7.13 Informix JDBC Drivers
        2.7.14 PostgreSQL JDBC Drivers
        2.7.15 MySQL JDBC Drivers
        2.7.16 Apache Derby JDBC Drivers
        2.7.17 SQLite JDBC Driver
        2.7.18 Firebird JDBC Driver
3. Connecting to a Server (CTRL + INSERT)
4. Disconnecting a Server (CTRL + DELETE)
5. Query Analyzer - SQL Tool in ADS 7.0
    5.1 Invoking the Query Analyzer (CTRL+Q)
    5.2 Using the Query Analyzer
    5.3 Query Analyzer and its Environment
    5.4 Using Advanced Properties
    5.5 Parameterized Scripts
    5.6 Displaying Results of Queries
    5.7 Saving Query Results
    5.8 Tips and Tricks
6. SQL History (CTRL+ ALT+H)
7. Automate your SQL scripts using ADS 7.0
    7.1.1 Adding Insert, Update, Delete and Select
    7.1.2 Introduce Columns and Value Stubs
    7.1.3 Comments and Morph to Delimited Text
    7.1.4 Formatting Statements
    7.2 Auto Completion
    7.3 Aqua Commands
8. Query Builder Tool in ADS 7.0
    8.1 Using the Query Builder
9. Charting Tool in ADS 7.0
    9.1 Invoking Charting Tools in ADS 7.0
    9.2 Working with Grids
    9.3 Working with Pivot Grids
    9.4 Advanced Features of Charting Tools
    9.5 Sample Charting Demo
10. SQL Query Tuning - Visual Explain Tools
    10.1 Invoking Execution Plans
    10.2 Using Explain Diagrams
    10.3 Sample Query Tuning Demo
11. GUI Tools for Creating Database Objects
    11.1.1 Creating Tables
    11.1.2 Creating Constraints
    11.1.3 Creating Indexes
    11.1.4 Creating Views and Triggers
    11.1.5 Creating Aliases and Synonyms
    11.1.6 Creating Storage Objects
    11.2 Multi Scripting Objects
12. Tools and Features available in ADS 7.0
    12.1 How to Import Data using ADS 7.0
    12.2 How to Export Data using ADS 7.0
    12.3 Generate SQL Scripts using ADS 7.0
    12.4 Table Data Editor
    12.5 Server Script Generator
    12.6 Using Object Search in ADS 7.0
    12.7 Comparing two Database Schemas
    12.8 Using Explain White Board
    12.9 Using Execution Monitor
    12.10 Generating ER Diagrams
13. Procedure Editor
    13.1 Sample Stored Procedure
14. Function Editor
    14.1 Sample User Defined Function
15. Package Editor
16. SQL Debugger
    16.1 Features of ADS 7.0 Debuggers
    16.1.1 Oracle Debugger
    16.1.2 DB2 Debugger
    16.1.3 MS SQL Debugger
    16.1.4 Sybase Debugger
17. ER Modeler in ADS 7.0
    17.1 Notation and Normalization
    17.2 Working with ER Modeler
    17.2.1 Creating Tables
    17.2.2 Creating Indexes
    17.2.3 Creating Constraints
    17.2.4 Creating Relationships
    17.2.5 Adding Notes and Regions
    17.2.6 Saving an ER Model
    17.3 Forward Engineering
    17.4 Reverse Engineering
    17.5 ER Modeler Demo
18. Version Control in ADS 7.0
    18.1 Using Subversion Repository
    18.2 Using CVS Repository
    18.3 Tips and Tricks
19. DBA Corner
    19.1 ORACLE DBA Tools
    19.1.1 Server Statistics
     19.1.2 Rollback Manager
     19.1.3 Log Manager
     19.1.4 Session Manager
     19.1.5 Instance Manager
     19.1.6 Storage Manager
     19.1.7 Security Manager
     19.1.8 SGA Manager
    19.2 SQL SERVER DBA Tools
    19.2.1 Instance Manager
    19.2.2 Session Manager
    19.2.3 Security Manager
    19.2.4 Storage Manager
    19.2.5 SQL Agent Manager
    19.3 SYBASE DBA Tools
    19.3.1 Instance Manager
    19.3.2 Session Manager
    19.3.3 Security Manager
    19.3.4 Storage Manager
    19.4 MySQL DBA Tools
    19.4.1 Instance Manager
    19.4.2 Session Manager
    19.4.3 Storage Manager
    19.4.4 Security Manager
    19.5 DB2 for LUW DBA Tools
    19.5.1 Instance Manager
    19.5.2 Session Manager
    19.5.3 Storage Manager
    19.5.4 Security Manager
20. Compare Tools in ADS 7.0
    20.1 File Compare
    20.2 Results Compare
    20.3 Directory Compare
    20.4 Tab Compare
    20.5 Schema Compare
    20.6 Copy History Compare
21. Editors available in ADS 7.0
    21.1.1 SQL Editor
    21.1.2 HTML Editor
    21.1.3 XML Editor
    21.1.4 Text Editor
    21.1.5 Regular Expressions
    21.2 Image Viewer
22. Application Workspace and Options
    22.1 Menus and Toolbar
    22.2 Shorcuts
    22.3 Schema and Script Browser
    22.4 Details View
23. Aqua Data Studio 7.0 OPTIONS
    23.1 General Options
    23.2 Editor Options
    23.3 Compare and Results Options
    23.4 Query Analyzer Options
    23.5 Scripts and Results Options
    23.6 Visual Explain Options
    23.7 Formatter Options
    23.8 Permissions and Registration Options
    23.9 Key Mapping Options and Key Assist Tool
    23.10 Settings: Find the application settings
24. Aqua Data Studio Technical Support
    24.1 Error Logging

8.1 Using the Query Builder

Tools - Query Builder

The Visual Query builder allows users to graphically select tables, views and relationships to build queries.

The user selects the tables and views desired in the query, maps the JOIN relationships between the tables, and then selects the columns needed in the results of the query. The user may then query for the results or copy the generated SQL statement to the Query Analzyer to manually work on it.

The Diagram Panel allows the user to select tables and views. User may then drag-n-drop columns from the source table to the target table to create JOIN representations. The user may right-click on the JOIN link and select properties to customize the JOIN.

The Columns Panel allows the user to customize the column parameters of the query. The column name provides a combo box for the user to select a column from a list based off of the selected tables in the Diagram Panel. The alias column allows the user to define an optional alias name for the column.

Panel Columns:
  Name: The name of the column or expression
  Alias: The alias name used for the column or expression
  Table: The name of the table
  Output: Determines if the column or expression is used in the SELECT statment
  Sort Type: Determines whether column is sorted and in what direction.
  Sort Order: Determines the sort level of the column
  Criteria: Criteria statement used in the WHERE clause of the statement
  Or ...: Defines optional criterias appended as OR criterias

The SQL Panel provides a read-only SQL representation of the Diagram Panel. The user may copy or save this SQL statement for later use.

The Results Panel provides a grid results equivalent to the grid results in the Query Analyzer window.

Query Builder Features:

  • General:
    • An ability to query accross different databases. When a user opens the Add Table Dialog, he/she can select tables from different databases and the Query Builder will generate an appropriate SQL for execution.
    • Has an ability to save queries to a file and and reopen the file. This allows the user to save working queries for later use, or to share them with other users.
    • Toolbar has a "reconnect" button to allow users to reconnect to the database in case the connection has been dropped by the database server.
    • When closing the query window the Query Builder prompts the user to "Cancel", "Discard", "Save" or "Save As".
    • Added Index Panel to show the indexes. When a user clicks on an index, the participating columns are highlighted at the Column Pane.
    • General: Filters button on toolbar now has the option "Database Qualified Tables"; if it’s selected, the Preview SQL window will display full database path for table qualification.
    • Toolbar provides information on "Username:", "Schema:" and "spid:"
    • Added options to save results: "Save" and "Save As"
    • Added navigation to the menubar->Window: Next Pane, Previous Pane, Next Index, Previous Index.
    • Hot Keys:
      • Press Alt-D or Alt-M hot keys to gain focus on Database or Max Results fields
      • Press Alt-Left or Alt-Right to go to the Previous Pane or to the Next Pane; Alt-PgUp or Alt-PgDown to go to the previous Index or to the Next Index respectivelly.
  • Add Table Dialog
    • Dialog has option for column selection. This option allows the user to specify what columns will automatically be selected into the Column Pane for the tables added into the query.
    • Dialog has database combo box which allows the user to change the context of the database, so that the user may select tables and views from different databases.
    • Under the application File->Options->General: Query Builder there is an option to "Show Add Table Dialog at startup" which allows the user to control whether the Add Dialog is displayed automatically when the Query Builder frame is initially displayed.
    • Auto-Find functionality allows the user to type the name of the table for a quick table lookup. The user may also specify a fully qualified table name (eg. Northwind.dbo.MyTable or Northwind..MyTable) and the auto find will change and the database context, refresh the tables and views and auto find the table.
    • Windows menu has the option "Limit Add Table to User Schema". This will limit options in the schema combo box to the user schema. This can provide a performance boost in scenarios when the database has a large number of user schemas and tables, by limiting the list of tables and views to the users objects.
    • Added hot key mnemonics to column selection type options (Column Selection)
    • Hot Keys
      • Press Alt-D or Alt-S hot keys to gain focus on Database or Schema comboboxes respectivelly.
  • Diagram Pane
    • Table and View panels in the Diagram have the primary key bolded and indexed columns italicized. This assists the user in identifing candidate columns for criteria creation.
    • Tables in diagram pane have extra items in popup menu: "Select All Columns", "Unselect All Columns", "Select All Indexed Columns" and "Select Leading Index Column".
  • Column Pane
    • The toolbar and windows menu have the options "Show Datatype", "Show Index" and "Show Index Order" which will enable/disable the columns in the Column Pane to identify the column datatype, the name of the indexes the column is bound to and the position the column is in the index.
    • Window menu has the option to place the columns pane into "Novice Mode". This will convert the criteria columns into only two columns consisting of the operation and value. Where the "Operater" is a combo box of the items "LIKE, =, IS NULL, NOT NULL, <>, >=, =", and "Criteria" is the column to enter the value
    • Window menu: Added "Clear Column Criteria" [Ctrl-Alt-K]
    • Operator combo box has a "" blank string as a selection.
    • items in popup menu: "Move Up", "Move Down", "Move Top" and "Move Bottom" for selected rows.
    • Delete when not in the cell editor will delete the full value of the cell for columns Alias, Operator, Criteria, Or1, Or2, or3 and Group By.
    • "NOT IN" operators in Quick Criteria mode.
    • Delete key on Columns Pane deletes all the selected cells not just the current one.
    • Hot Keys:
      • When in Cell Editor Shift-Ctrl-Left/Right/Home would close the cell editor.
      • Alt-Down now activates popup menu
      • Ctrl-Alt-K clears Column Criteria
  • Grid Results:
    • Autosearch feature. If the user starts typing in the grid, autosearch will begin similar to the Query Analyzer.
    • Table search is cleared after table is selected with an "enter" key.
    • Added "View In" to popup menu similar to the Query Analyzer.
    • Double click on tab of results will expand/collapse results pane

Table Data Editor Features

  • Option to save queries to SQL History: This option can be enabled/disabled in File->Options->Table Editor. When the option is enabled, queries generated in Query Builder are saved to SQL History after being executed and commited. With the Full (default) transaction type all of the queries are saved as one entry, otherwise queries are saved by batches being commited. If a query or a batch fails, including the case when a user cancels it, further queries are not executed and not saved.

 Enhancements

  • Add Table: Add Table Dialog now has the ability to sort columns on Table and View grid.
  • Column Grid Table:  The Column Grid Table is now sortable.