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.6 MS SQL Server

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.

Tab Coloring

To Identify Server Environments, whether it is a Production, Development or Test, use Tab Coloring feature :

  • Locate the Server in the Server Browser
  • Right Click on the Server - A Popup Menu Appears
  • Click on the Item which displays Server Properties.
  • Based on the Server Type, you can edit the Tab Coloring option to identify your environments.

Tip : Using the Keyboard combination "CTRL + SHIFT + P", you may quickly access Server Properties and edit Tab Coloring options.


Connecting and Use with MS SQL Server Debugger (Microsoft SQL Server 2005 and above) -  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.

Configuring DCOM security on SQL Server for Aqua Data Studio debugger:

In case granting "administrators" permission is a concern, then :-

  • You can create a local user under "Users" group.
  • Then go to Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > Security Options :-
    • Double-click "DCOM: Machine Access Restrictions" policy, click Edit Security, add the user created above, allow "Remote Access"
    • Double-click "DCOM: Machine Launch Restrictions" policy, click Edit Security, add the user created above, allow "Local Launch", "Remote Launch", "Local Activation", "Remote Activation"
    • Double-click "Network Access: Sharing and Security Model for local accounts" policy, and set to Classic"
  • Go to Control Panel > Administrative Tools > Component Services > Computers > right-click My Computer > click Properties > click COM Security tab :-
    • In Access Permissions section, click Edit Default > add the user created above, allow "Remote Access"
    • In Launch and Activation Permissions section > click Edit Default > add the user created above, allow "Local Launch", "Remote Launch", "Local Activation", "Remote Activation"
  • Disable Windows Firewall or any other Firewall software that would prevent DCOM clients from connecting to the DCOM server.
  • (You can also go to a specific component in the Component Services section to grant permission, instead of granting permission from "My Computer" which is a blanket grant)


Using Filters Options in Registration (Filters Tab)

Edit the Server Properties, to use FILTER options for a 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.
  • Go to the Filters Tab and make changes in the Options.
  • Filter Databases/Schemas: Allows the user to specify the main schema browser filter for databases or schemas, on whether to include or exlude all.
  • Include Databases/Schemas: A list of databases/schemas to include after the main filter is applied.
  • Exclude Databases/Schemas: A list of databases/schemas to exclude after the main filter is applied.
  • Filter Objects: Allows the user to specify the main schema browser filter for object types, on whether to include or exlude all.
  • Include Objects: A list of objects to include after the main filter is applied.
  • Exclude Objects: A list of objects to exclude after the main filter is applied.

Features

  • You can Create, Edit or Delete Object Folders. Default Folders are Tables, System Tables, Views, Indexes, Triggers, Procedures, Functions.
  • Sometimes you would like to view only specific Schemas. Use options to INCLUDE or EXCLUDE all Schemas and Folders.
  • Enter the Schema or Folder name in the specified text area and Press OK. Current Connection will be terminated. Reconnect to see the changes.

Tip : Using the dropdown at the top of the Filter Tab, quickly change your Schema or Folder View.


Using Advanced Properties (Advanced Tab)

Edit the Server Properties to use Advanced Properties 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.
  • Go to the Advanced Tab and make changes in the Options.

  With options in Advanced properties of a Server, you can :

  • Change Transaction Isolation Modes.
  • Driver Parameters.
  • Enable Database Filters in Query Analyzer.
  • Change Read Only / Read- Write Mode.
  • Change Object Folder Display.
  • Txn Isolation Level: Support for setting Transaction Isolation Level
    - TRANSACTION_NONE - A constant indicating that transactions are not supported.
    - TRANSACTION_READ_COMMITTED - A constant indicating that dirty reads are prevented; non-repeatable reads and phantom reads can occur.
    - TRANSACTION_READ_UNCOMMITTED - A constant indicating that dirty reads, non-repeatable reads and phantom reads can occur.
    - TRANSACTION_REPEATABLE_READ - A constant indicating that dirty reads and non-repeatable reads are prevented; phantom reads can occur.
    - TRANSACTION_SERIALIZABLE - A constant indicating that dirty reads, non-repeatable reads and phantom reads are prevented.
  • Driver Param: This option is to allow a user to specify extra JDBC parameters that a user might want use in estabilishing a connection.
  • Charset: Character set used for the connection.
  • Set quoted_identifier: Causes connection to follow the SQL-92 rules regarding quotation mark delimiting identifiers and literal strings.
  • Set ansi_nulls: Causes connection to follow SQL-92 compliant behavior of the Equals (=) and Not Equal to (<>) comparison operators when used with null values.
  • Set ansi_null_dflt_on: Causes connection behavior to override default nullability of new columns when the ANSI null default option for the database is false.
  • Set ansi_padding: Changes connection behavior in the way the column stores values shorter than the defined size of the column, and the way the column stores values that have trailing blanks in char, varchar, binary, and varbinary data.
  • Set ansi_warnings: Specifies SQL-92 standard behavior for several error conditions.

Tip : Using the dropdown at the bottom of the Advanced Tab, quickly change your Object Display in the Server Browser.


Server Permissions (Permissions Tab)

  Edit the Permissions in Server Properties 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.
  • Go to the Permissions Tab and make changes in the Options.

  With options in Permissions Tab of a Server, you can :

  • Control Statement execution and Properties of the Query Analyzer, Table Data Editor and Visual Editing.
  • Grant / Revoke Permissions easily for executing DDL and DML Statements in the Query Analyzer.
  • Change the behaviour of the Table Data Editor for manipulating rows in Tables.
  • Grant / Revoke Alters, Creates, Drops and View Properties of Visual Editing Tools.

Server Scripts (Scripts Tab)

  Edit Scripts in Server Properties 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.
  • Go to the Scripts Tab and make changes in the Options.

  With scripts in the Scripts Tab of a Server, you can :

  • enter an SQL Script that is executed each time a new connection is established.
  • This allows user to SET connection settings for a server connection. (eg: SET ROLE, ALTER SESSION SET XXX)

Registering Servers - SQL Server Express 2005

Configuring SQL Express and connecting with Aqua Data Studio.

Connecting to SQL Server Express with Aqua Data Studio requires that you have remote connections enabled accepting TCP/IP connections. Once you have TCP/IP network connections enabled, you can connect to SQL Server Express using the hostname and instance name in the Host: parameter.

SQL Server Express Surface Area

1. Launching ’SQL Server Surface Area Configuration’ tool: First step is to launch the SQL Server surface area configuration tool that is installed with SQL Server Express.

Remote Surface Area Configuration

2. Configuring TCP/IP Remote Connections: Select ’Surface Area Configuration and Services and Connections’ option and then select ’Remote Connections’ in the tree browser. Choose the ’Using TCP/IP Only’ or ’Using both TCP/IP and named pipes’, the click on ’Ok’ or ’Apply’.

Register Server

3. Register Connections: Now, register a server connection in Aqua Data Studio using ’HostnameSQLEXPRESS’ as the hostname parameter, where Hostname is the hostname or ip address of the SQL Server and SQLEXPRESS is the instance name.

The MS SQL Server Debugger works with MS SQL Server 2005 Express just as it does for MS SQL Server 2005. Click here for more information on how to register a server for debugging with the MS SQL Server Debugger.

 

 

 

 






Registering Servers - SQL Server 2000 MSDE (Desktop Edition)

Configuring MSDE and connecting with Aqua Data Studio.

Connecting to SQL Server 2000 MSDE with Aqua Data Studio requires that you have remote connections enabled accepting TCP/IP connections. Once you have TCP/IP network connections enabled, you can connect to SQL Server MSDE using the hostname and instance name in the Host: parameter.

1. Installing MSDE with Network Connections enabled:

First step is to install MSDE with network connections enabled. By default, MSDE is installed with network connections disabled. To install MSDE with with network connections, you must run the setup.exe from the command prompt and specifying the DISABLENETWORKPROTOCOLS=0. As described in the MSDE installation docs ...

Setup Parameters

Installation docs:
MSDE Installation Instructions

MSDE SupeSocketNetLib Registry

MSDE TCP Registry

2. Verifing TCP/IP Remote Connections:

To verify that your MSDE installation has remote connections enabled you may run "regedit" to view your registry settings. Verify the following keys ...

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\
MSDE\MSSQLServer\SuperSocketNetLib\ProtocolList=[tcp np]

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\
MSDE\MSSQLServer\SuperSocketNetLib\Tcp\TcpPort=[Port]

Registration - SQL Server

3. Register Connections: Now, register a server connection in Aqua Data Studio using ’Hostname\SQLEXPRESS’ as the hostname parameter, where Hostname is the hostname or ip address of the SQL Server and SQLEXPRESS is the instance name.