Documentation 7.5
Aqua Data Studio 7.5
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 Choose Your Language
    1.7 Character set and Internationalization
2. Server Registration
    2.1 Supported RDBMS Servers in ADS 7.5
    2.2 How to Register a Server in ADS 7.5
    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.5
    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.5
    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.5
    8.1 Building Queries
    8.2 Workspace Reference
9. Charting Tool in ADS 7.5
    9.1 Working with Grids
    9.2 Working with Pivot Grids
    9.3 Working with new & Enhanced Charts
    9.4 Scripting Charts
    9.5 Chart Options
    9.6 Function Series
    9.7 Chart Gallery
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.5
    12.1 How to Import Data using ADS 7.5
    12.2 How to Export Data using ADS 7.5
    12.3 Generate SQL Scripts using ADS 7.5
    12.4 Table Data Editor
    12.5 Server Script Generator
    12.6 Using Object Search in ADS 7.5
    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
    15.1 Sample Package Editing Demo
16. SQL Debugger
    16.1 Invoking ADS 7.5 SQL Debuggers
    16.2 Features of ADS 7.5 Debuggers
    16.2.1 Oracle Debugger
    16.2.2 DB2 Debugger
    16.2.3 MS SQL Debugger
    16.2.4 Sybase Debugger
    16.3 Debugging Stored Procedure Demo
17. ER Modeler in ADS 7.5
    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.5
    18.1 Using Subversion Repository
    18.2 Using CVS Repository
    18.3 File Search in Version Control
    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.5
    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.5
    21.1.1 SQL Editor
    21.1.2 Java and JavaScript Editor
    21.1.3 HTML Editor
    21.1.4 XML Editor
    21.1.5 Text Editor
    21.1.6 Regular Expressions
    21.2 Image Viewer
22. Application Workspace and Options
    22.1 Menus and Toolbar
    22.2 Shortcuts
    22.3 Schema and Script Browser
    22.4 Details View
23. Aqua Data Studio 7.5 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
    23.11 Command line
24. Aqua Data Studio Technical Support
    24.1 Error Logging

2.2 How to Register a Server in ADS 7.5

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 "Application: Settings" section for more information on sharing and portability of Aqua Data Studio configurations.

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

 

Register Oracle Server - If you have any issues connecting to your Oracle instance, make sure that you can ping your server with ’tnsping’. Also, make sure you have the correct JDBC driver if you are connecting through OCI libraries.  (Drivers)

Aqua Data Studio also allows you to connect to Oracle RAC and Oracle Connection Manager by entering into "Host" value:

Oracle Connection Manager Examples:

(description=(address_list=(address=(protocol=tcp)(port=1610)(host=webHost)) (address=(protocol=tcp)(port=1521)(host=oraHost))) (connect_data=(INSTANCE_NAME=orcl))(source_route=yes))

Oracle RAC Examples:

(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=PRIMARY_NODE_HOSTNAME)(PORT=1521)) (ADDRESS=(PROTOCOL=TCP)(HOST=SECONDARY_NODE_HOSTNAME)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=DATABASE_SERVICENAME)))

(DESCRIPTION=(FAILOVER=ON)(ADDRESS_LIST=(LOAD_BALANCE=ON)(ADDRESS=(PROTOCOL=TCP)(HOST=xxxxx) (PORT=1526))(ADDRESS=(PROTOCOL=TCP)(HOST=xxxx)(PORT=1526))) (CONNECT_DATA=(SERVICE_NAME=somesid)))

Register DB2 Server - Before connecting to your server, make sure you have the appropriate driver for your DB2 version and fixpack.
Register Informix Server - Informix registrations should be straight forward.

Register Microsoft SQL Server - SQL Server registrations should be straight forward.

Windows Single Sign-On - Aqua Data Studio supports trusted single sign-on connections to SQL Server on the Windows platform. You may specify the authentication as "Windows Single Sign-On", which will allow ADS to login into a server using the currently logged in authentication of the OS. This is only supported on the Windows platform, and not on Linux, OSX or other platforms. For other platforms use the "Windows Authentication" option.

Windows Authentication - Aqua Data Studio supports trusted connections to SQL Server on non-Windows platforms. You may specify the authentication as "Windows Authentication" and specify the Domain/Username and password of the user to authenticate with.

Connecting to Multiple Instances of SQL Server on the same machine - When registering an SQL Server you may specify in the Hostname text the name of the SQL Server and the Instance name in the format \\ServerName\InstanceName without a port, to enable an Instance connection. You may also connect to multiple Instances of SQL Server on the same machine by identifying on what ports each Instance is running. For SQL Server 2000 you can run the "SQL Server Network Utility". You may then select the Instance of SQL Server and make sure the "TCP/IP" protocol is enabled. Then you may select the TCP/IP protocol and click properties, this should tell you the default port.

Once you know the port of each Instance you may register a connection for each Instance by specifying the hostname and the port for each connection/instance.

Connecting and Use with MS SQL Server Debugger (Microsoft SQL Server 2005) -  The Advanced Tab requires entering Domain, Username and Password when connecting to SQL Server 2005 for debugging.  If your SQL Server is not part of a domain, enter its IP address as the domain.

When registering an SQL Server for use with the MS SQL Server Debugger it is important to set the security on the server itself to allow for the debugger’s connection. On the server hosting SQL Server 2005, the following must be set correctly to allow for debugging.

  • Configure DCOM Security
  • Disable the server’s Firewall.
Register PostgreSQL Server - If you have issues connecting to your PostgreSQL server, make sure that you have started your PostgreSQL postmaster with the ’-i’ option which enables TCP/IP connections. TCP/IP connections are required for ADS to connect to the PostgreSQL server.
Register MySQL Server - Before connecting to MySQL you will need to GRANT access to your user and machine. Because the MySQL JDBC driver uses TCP/IP sockets instead of Unix Domain Sockets, the security manager in MySQL server will use the HOSTS table to determine whether or not the connection should be allowed. To grant your user access use this syntax: "GRANT ALL PRIVILEGES ON [dbname].* to ’[user]’@’[hostname]’ identified by ’[password]’" to generate and execute an SQL command.
Register Sybase Server - Sybase registrations should be straight forward, although you should make sure your Sybase server has had the Sybase sql_serverXX.sql meta data script applied to it as documented in your Sybase documentation. This script is usually applied during installation by default.
Register Sybase Anywhere Server - Sybase Anywhere registrations should be straight forward.
Register Sybase IQ Server - Sybase IQ registrations should be straight forward.
Register Apache Derby - Apache Derby registrations should be straight forward.  
Register Generic JDBC & ODBC Server - When registering a server using the Generic-JDBC connection type, make sure you specify the location of the driver which you will be using, with the correct URL and driver name. When registering a Generic-ODBC connection make sure that an ODBC datasource has already been created for use.