Documentation 8.0
Aqua Data Studio 8.0
Supported RDBMS Servers
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 Launcher & Memory Configuration
    1.6 Interface Language, Fonts & Character sets
    1.7 Charts and OpenGL/JOGL Configuration
    1.8 Application Logs & Support Information
    1.9 Configuration & Connection files
2. Registering a Database Server
    2.1 Oracle
    2.2 Oracle OCI
    2.3 DB2 iSeries
    2.4 DB2 LUW
    2.5 DB2 zOS
    2.6 MS SQL Server
    2.7 Sybase ASE
    2.8 Sybase Anywhere
    2.9 Sybase IQ
    2.10 Informix
    2.11 Teradata
    2.12 Aster nCluster
    2.13 MySQL
    2.14 PostgreSQL
    2.15 Apache Derby
    2.16 Generic JDBC
    2.17 Generic ODBC
3. JDBC Driver Configuration
    3.1 Oracle 8i JDBC Drivers
    3.2 Oracle 9i JDBC Drivers
    3.3 Oracle 10g JDBC Drivers
    3.4 Oracle 11g JDBC Drivers
    3.5 DB2 iSeries JDBC Drivers
    3.6 DB2 z/OS JDBC Drivers
    3.7 DB2 LUW 7.2 JDBC Drivers
    3.8 DB2 LUW 8.1 and DB2 UDB 8.2
    3.9 DB2 LUW 9.0 and DB2 UDB 9.5
    3.10 SQL Server JDBC Drivers
    3.11 Sybase ASE JDBC Drivers
    3.12 Sybase Anywhere JDBC Drivers
    3.13 Sybase IQ JDBC Drivers
    3.14 Informix JDBC Drivers
    3.15 Teradata JDBC Drivers
    3.16 Aster nCluster Drivers
    3.17 PostgreSQL JDBC Drivers
    3.18 MySQL JDBC Drivers
    3.19 Apache Derby JDBC Drivers
    3.20 SQLite JDBC Drivers
    3.21 Firebird JDBC Drivers
4. Workspace and Docking Framework
    4.1 Menus and Toolbar
    4.2 Shortcuts Toolbar
    4.3 Schema Browser
    4.4 Scripts Browser
    4.5 Details View
5. Query Analyzer - SQL Tool in ADS
    5.1 Invoking the Query Analyzer (CTRL+Q)
    5.2 Using the Query Analyzer
    5.3 Query Analyzer and its Environment
    5.4 Server Side Comments
    5.5 Parameterized Scripts
    5.6 Displaying Results of Queries
    5.7 Saving Query Results
    5.8 Tips and Tricks
    5.9. SQL Automation
        5.9.1 Insert, Update, Select
        5.9.2 Introduce Columns and Value Stubs
        5.9.3 Morph to Delimited List
        5.9.4 Formatting Statements
        5.9.5 Auto Completion
        5.9.6 Aqua Commands
    5.10. Charting Grids and Pivot Grids
        5.10.1 Working with Grids and Pivot Grids
        5.10.2 Working with Enhanced Charts
        5.10.3 Scripting Charts
        5.10.4 Chart Options
        5.10.5 Function Series
    5.11. Visual Explain Plan
        5.11.1 Using Explain Diagrams
        5.11.2 Sample Query Tuning Demo
6. SQL History (CTRL+ ALT+H)
7. Query Builder Tool in ADS
    7.1 Building Queries
    7.2 Workspace Reference
8. GUI Tools for Database Objects
    8.1 Creating Databases
    8.2 Creating Tables
    8.3 Creating Constraints
    8.4 Creating Indexes
    8.5 Creating Views & Triggers
    8.6 Creating Aliases & Synonyms
    8.7 Creating Storage Objects
    8.8 Multi Scripting Objects
9. Tools and Features
    9.1 How to Import Data using ADS
    9.2 How to Export Data using ADS
    9.3 Generate SQL Scripts using ADS
    9.4 Table Data Editor
    9.5 Server Script Generator
    9.6 Using Object Search in ADS
    9.7 Comparing two Database Schemas
    9.8 Using the Visual Explain White Board
    9.9 Using the Execution Monitor
    9.10 Generating ER Diagrams
10. Procedure, Function & Package Editor
11. SQL Debugger
    11.1.1 Oracle Debugger
    11.1.2 DB2 Debugger
    11.1.3 MS SQL Debugger
    11.1.4 Sybase Debugger
12. ER Modeler in ADS
    12.1 Notation and Normalization
    12.2 Creating Tables
    12.3 Creating Indexes
    12.4 Creating Constraints
    12.5 Creating Relationships & Subcategories
    12.6 Adding Notes and Regions
    12.7 Saving and Exporting an ER Model
    12.8 Forward Engineering
    12.9 Reverse Engineering
    12.10 ER Modeler Demo
    12.11 Converting ER Models DB to DB
13. Version Control in ADS
    13.1 Using a Subversion Repository
    13.2 Using a CVS Repository
    13.3 File Search in Version Control
14. Database Administrator Tools
    14.1 ORACLE DBA Tools
        14.1.1 Server Statistics
         14.1.2 Rollback Manager
         14.1.3 Log Manager
         14.1.4 Session Manager
         14.1.5 Instance Manager
         14.1.6 Storage Manager
         14.1.7 Security Manager
         14.1.8 SGA Manager
    14.2 SQL SERVER DBA Tools
        14.2.1 Instance Manager
        14.2.2 Session Manager
        14.2.3 Security Manager
        14.2.4 Storage Manager
        14.2.5 SQL Agent Manager
    14.3 SYBASE DBA Tools
        14.3.1 Instance Manager
        14.3.2 Session Manager
        14.3.3 Security Manager
        14.3.4 Storage Manager
    14.4 MySQL DBA Tools
        14.4.1 Instance Manager
        14.4.2 Session Manager
        14.4.3 Storage Manager
        14.4.4 Security Manager
    14.5 DB2 for LUW DBA Tools
        14.5.1 Instance Manager
        14.5.2 Session Manager
        14.5.3 Storage Manager
        14.5.4 Security Manager
15. Compare Tools in ADS
    15.1 File Compare
    15.2 Results Compare
    15.3 Directory Compare
    15.4 Tab Compare
    15.5 Schema Compare
    15.6 Copy History Compare
16. Editors & Viewers
17. Aqua Data Studio OPTIONS
    17.1 General Options
    17.2 Editor Options
    17.3 Compare and Results Options
    17.4 Query Analyzer Options
    17.5 Scripts and Results Options
    17.6 Visual Explain Options
    17.7 Formatter Options
    17.8 Permissions and Registration Options
    17.9 Key Mapping Options and Key Assist Tool
    17.10 Command line

2. Registering a Database Server

Registering Servers

Once you have installed Aqua Data Studio you will need to register your servers before you get started. There are three methods of registering servers, all of which launch the Register Server dialog

  • You can navigate to the Main Application Menu to Server, then select Register Server
  • You can right-click in the Schema Browser to bring up the context menu and select Register Server
  • You can also click the Query Analyzer Icon at the top left of the Main Application window

All of these launches the Register Server dialog, which lets you fill in the properties of the server you are attempting to connect to.

The properties of any registered server can be viewed and altered by right-clicking on a server in the Schema Browser and selecting "Server Properties."

There are defaults set for the different RDBMSes within the Register Server Dialog, depending on the database vendor and version chosen. In most cases it is good to use these defaults. There is some variation in how different database types are registered and it is important to have the correct drivers. For more information on drivers see the "JDBC Drivers" section.

It is  possible to register servers by using a configuration copied from another user. The servers from a copied configuration will populate the schema browser, but passwords will have to be entered within the properties of each one. Passwords do not copy when configurations are duplicated. See the "Configuration & Connection Files" section for more information on sharing and portability of Aqua Data Studio configurations.

Each section below offers specific notes for the different database types.

Server Registration in Aqua Data Studio

New Server Group Group Name Register Server Enter Server Details Server Registered Connect
New Server Group Group Name
Register Server Enter Server Details Server Registered Connect

  To Register a Server :

  • Create a new Server Group in the Server Node
  • Right Click on the Server Group - A Popup Menu Appears. Click on the Item which displays Register Server
  • Select the RDBMS Driver. Specify a name. Enter Authentication details, Host and Port.
  • Once the Server is successfully registered, it appears in the Server Group Node. You can now Connect to the Server and view the Schema Objects

Tip : Select the Database Server you want to connect to and use the keyboard combination "Shift + INSERT" to quickly create a Clone of the Server

 

Troubleshooting Registrations

User name & Password Click on Ping Driver
User name & Password
Click on Ping
Driver

If you face any problem during Server Registration, there might be a few things which you are doing wrong :

  • Check the User name and Password. Most problems are solved by if you enter the correct authentication information.
  • Perform Socket connection test - Click on the Ping button.
  • Ensure that you have selected the correct RDBMS Driver initially.
  • Make sure that the Database Server to which you are trying to connect Aqua Data studio Client is up and running.

Tip : Tick the ’Save Password’ check box and you may quickly connect to a Server without having to type in the authentication every time you Connect.

 

How to edit server properties

 
To Edit the Server Properties of an already Registered Server, in Aqua Data Studio :

  • Locate the Server in the Server Browser.
  • Right Click on the Server - A Popup Menu Appears.
  • Click on the Item which displays Server Properties.

You can change Server Properties like

  • Name.
  • Type.
  • Tab Color.
  • Authentication.
  • Location - which includes Host and Port.

You can also edit Filters for Schema and Folders, Advanced Properties and Permissions.

Tip : Using the Keyboard combination "CTRL + SHIFT + P", you may quickly edit Server Properties.

 

How to register a server clone

Clone - Main Menu Right click Server Specify Name
Clone - Main Menu
Right click Server
Specify Name

 To create a Server Clone of an already Registered Server, in Aqua Data Studio:

  • Locate the Server in the Server Browser.
  • Right Click on the Server - A Popup Menu Appears.
  • Click on the Item which displays Register Server Clone.
  • Once you provide a new name for the clone, a new Server is registered.

You can now connect to the newly registered Server and perform Data Manipulations.

Tip : Using the Keyboard combination "SHIFT + INSERT", you may quickly create a Server Clone.


Using Aqua Data Studio to connect to a Server

Locate the Server Select the Database Popup Green Icon - Connected
Locate the Server Select the Database Popup
Green Icon - Connected

 To Connect a registered Server :

  • Locate the Server in the Server Browser
  • Select the Database
  • Right Click on the Database Server - A Popup Menu Appears. Click on the first Item which displays Connect
  • Once the icon changes to green color, you are connected to the Server. You can expand the tree node to view the Schema Objects. Numerous tools like Query Analyzer, Query Builder, ER Modeler aids in assists with your operations

Tip : Select the Database Server you want to connect to and use the keyboard combination "CTRL + INSERT" to quickly Connect to the Server

 

Using Aqua Data Studio to disconnect a Server

Locate the Server Right Click - Popup Disconnected
Locate the Server Right Click - Popup Disconnected

 To Disconnect a registered Server :

  • Locate the Server in the Server Browser
  • Select the Database Server you want to Disconnect
  • Right Click on the Server - A Popup Menu Appears. Click on the second Item which displays Disconnect
  • Once the icon changes tfrom the green color and the tree node is collapsed, you are disconnected from the Server

Tip : Select the Database Server you want to disconnect and use the keyboard combination "CTRL + DELETE" to quickly Disconnect from the Server

To share or copy registered server connections for use on another computer, see Configuration & Connection Files