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

2.7. JDBC Drivers and Server Registration

JDBC Drivers

JDBC Driver Usage - Aqua Data Studio uses JDBC drivers to make database connections to the appropriate database. By default, Aqua Data Studio comes packaged with an appropriate JDBC driver for all supported databases. The included drivers work for most database versions and setups. In specific configurations you may be required to update the JDBC driver in your Aqua Data Studio installation with the latest driver from the database vendor. Below is a list of databases, the corresponding issues that may arise and the appropriate action to take to resolve the issue.
Apache Derby JDBC Driver - Apache Derby drivers included with ADS work with all versison of Apache Derby. There is no need to update this driver


Vendor: Apache DB Project
Driver URL:  http://db.apache.org/derby/derby_downloads.html
Driver Location (Windows/Linux):
[ADS_INSTALL]\lib\drivers\derby.jar
[ADS_INSTALL]\lib\drivers\derbyclient.jar
[ADS_INSTALL]\lib\drivers\derbynet.jar
Driver Location (OSX):
/Aqua Data Studio/Contents/Resources/Java/drivers/derby.jar
/Aqua Data Studio/Contents/Resources/Java/drivers/derbyclient.jar
/Aqua Data Studio/Contents/Resources/Java/drivers/derbynet.jar
DB2 7.2 JDBC Driver - DB2 7.2 is the database which has the most connection issues. JDBC drivers for database version are not compatible, neither are they compatible across fixpacks. Updating your DB2 JDBC driver to the version which you are using is always a good idea. The DB2 Server installation provides JDBC drivers for the version and fixpack in use. You may copy the provided JDBC driver and overwrite the driver provided by ADS. You can copy the /sqllib/java/db2java.zip that comes with your installation and overwrite the /ADS_INSTALLATION/lib/drivers/db2java.jar file.

- NOTE: The DB2 7.2 JDBC driver does not connect directly to the DB2 Server, but to a proxy server which is installed with the DB2 Server. This proxy server can be started with the db2jstrt[.exe], which defaults to port 6789. The process is enabled by default in most installations.

Vendor: IBM
Driver URL: DB2 Server Installation ([DB2 Install]\java\db2java.zip)
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\db2java.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/db2java.jar
DB2 8.1 - 9.x JDBC Driver - The DB2 JDBC drivers included with ADS work across all 8.x versions of DB2. There is no need to change or update this driver.

Vendor: IBM (JDBC Type 4 Driver)
Driver URL: http://www.ibm.com/support/us/
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\db2jcc.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/db2jcc.jar
DB2 iSeries - IBM as400 JDBC Driver - The IBM as400 JDBC drivers included with ADS work across all iSeries versions of DB2. There is no need to change or update this driver.

Vendor: JTOpen
Driver URL: http://jt400.sourceforge.net/
Driver Location (Windows/Linux):
[ADS_INSTALL]\lib\drivers\jt400.jar
[ADS_INSTALL]\lib\drivers\util400.jar
Driver Location (OSX):
/Aqua Data Studio/Contents/Resources/Java/drivers/jt400.jar
/Aqua Data Studio/Contents/Resources/Java/drivers/util400.jar
Oracle JDBC Drivers - Oracle JDBC drivers provide compatibilty between different version of the Oracle server. Oracle JDBC/OCI drivers do not provide support between OCI libraries. The JDBC driver included with ADS supports native connections to Oracle 10g/9i/8i, but only OCI connections with the 10g client software. If you have the 8i/9i OCI client drivers installed on your machine and you would like to use them with ADS then you will need to install the Oracle 8i/9i JDBC driver, which has support for 8i/9i OCI libraries.

- For Oracle you can copy the /oraxx/jdbc/lib/classes12.jar that comes with your installation and overwrite the /ADS_INSTALLATION/lib/drivers/oracle.jar file.

Note OSX Installations: OCI Connections are not supported on OSX. There is no need to change or update the drivers on OSX.

Vendor: Oracle
Driver URL: [Free Registration Required] http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html
Driver Location (Windows/Linux):
[ADS_INSTALL]\lib\drivers\oracle.jar
ADS_INSTALL]\lib\nlscharset12.jar
Driver Location (OSX): 
/Aqua Data Studio/Contents/Resources/Java/drivers/oracle.jar
/Aqua Data Studio/Contents/Resources/Java/drivers/nlscharset12.jar
Microsoft SQL Server JDBC Drivers - The jTDS JDBC (v1.0) drivers included with ADS work across all versions of SQL Server. There is no need to change or update this driver.

Vendor: jTDS Open Source Project
Driver URL: http://sourceforge.net/project/showfiles.php?group_id=33291
Driver Location (Windows): [ADS_INSTALL]\lib\drivers\jtds.jar & [ADS_INSTALL]\ntlmauth.dll
Driver Location (Linux): [ADS_INSTALL]\lib\drivers\jtds.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/jtds.jar
PostgreSQL JDBC Drivers - The PostgreSQL JDBC (v8.0.401) drivers included with ADS work across all versions of PostgreSQL from 7.2 to 8.0. PostgreSQL server releases are frequent, and may sometimes require updating the JDBC driver.

Vendor: PostgreSQL
Driver URL: http://jdbc.postgresql.org/download.html
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\postgresql.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/postgresql.jar
MySQL JDBC Drivers - The MySQL JDBC (v3.1.10) drivers included with ADS work across all versions of MySQL from 3.x to 4.1. MySQL server releases are very frequent, and may sometimes require updating the JDBC driver.

Vendor: MySQL
Driver URL: http://www.mysql.com/products/connector/j/
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\mysql.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/mysql.jar
Sybase Anywhere JDBC Drivers - The Sybase Anywhere JDBC drivers included with ADS work across all versions of Sybase Anywhere from 7.0 to 9.0. There is no need to change or update this driver.

Vendor: Sybase (jConnect 6.0)
Driver URL: http://www.sybase.com/downloads
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\jconnect60.jar.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/jconnect60.jar
Sybase JDBC Drivers - The Sybase JDBC drivers included with ADS work across all versions of Sybase from 11.0 to 12.5. There is no need to change or update this driver.

NOTE: For your Sybase JDBC driver to work properly, your Sybase server must have the latest EBT/Maintenance patches applied to them. The sql_server_xxx.sql scripts contain metadata required by the JDBC drivers.

Vendor: Sybase (jConnect 6.0)
Driver URL: http://www.sybase.com/downloads
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\jconnect45.jar & [ADS_INSTALL]\lib\drivers\jconnect55.jar & [ADS_INSTALL]\lib\drivers\jconnect60.jar
Driver Location (OSX):
/Aqua Data Studio/Contents/Resources/Java/drivers/jconnect45.jar
/Aqua Data Studio/Contents/Resources/Java/drivers/jconnect55.jar
/Aqua Data Studio/Contents/Resources/Java/drivers/jconnect60.jar
Informix JDBC Drivers - The Informix JDBC drivers included with ADS work across all versions of Informix. There is no need to change or update this driver.

Vendor: IBM
Driver URL: http://www.iiug.org/home.html
Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\ifxjdbc.jar
Driver Location (OSX):  /Aqua Data Studio/Contents/Resources/Java/drivers/ifxjdbc.jar