Oracle OCI

If you have any issues connecting to your Oracle instance, make sure that you can ping your server with ’tnsping’.

Make sure you have the correct JDBC driver if you are connecting through OCI libraries.  (Drivers)

Contents

• General Tab
  • Change Server Password
  • Connection Type - TNS Network Alias
  • Connection Type - TNS Connect Descriptor
    • Oracle Connection Manager Examples & Oracle RAC Examples
• Using Filters Options in Registration (Filters Tab)
  • Filter Examples
• Using Advanced Properties (Advanced Tab)
• Using Driver Properties (Driver Tab)
• Server Permissions (Permissions Tab)
• Server Scripts (Scripts Tab)
• Shell Scripts (FluidShell Tab)

General Tab

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.

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

Change Server Password

The change server password button is only enabled while Editing Server Properties and when connected as Normal user. Change Password will only work under the following conditions:

1) The OCI client library version should match the server version exactly. If the server is v11.0.2.3 then the OCI driver must be for v11.0.2.3. The user should copy the matched, version-specific jdbc drivers .jar file(s) from oracle client installation to ADS_HOME/drivers/lib  (for more on how to do this, see our Drivers page).
2) The environment variable TNS_ADMIN should be configured to the directory containing tnsnames.ora file.

Connection Type - TNS  Network Alias

Browse to select a network alias from the tnsnames.ora file. TNS - Network Alias uses the Environment Variable TNS_ADMIN is used and if it is not found, the Environment Variable ORACLE_HOME is used to find the tnsnames.ora file. 

Connection Type - TNS Connect Descriptor

Aqua Data Studio also allows you to connect to Oracle RAC and Oracle Connection Manager by entering into the Descriptor field.

Oracle Connection Manager TNS Descriptor 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 TNS Descriptor 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)))

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.
• Filters are case sensitive
• Filter Databases works on the list of Schemas
• Filter Folders works on the list of folders inside a particular Schema. Example folders: Tables, View, Procedures, etc.
• Object Folder filter works on individual folders inside a particular Schema. The user can define filters for each of the Tables, Views, etc. folders.

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

Filter Examples:

If your intention is to show only the tables that start with XXPKD, then you'll need to change your main filter to "Exclude All", and secondary filter to "+XXPKD*". Note the "+" in front of the XXPKD pattern. Also note that the filter pattern is case sensitive.

The filter shown below is set to exclude all databases except those that start with "aq". This is similar to the above example where all schemas, except the XXPKD schema, are excluded. Then, there is an "Object Folder" filter on the Tables folder, which excludes everything except those that start with "forum".

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.
• JDBC Escape Processing:    
• Always Display Column Name in Results:    
• Enable db filters for query window: enables/disables db filters for query windows using this connection.
• Only display databases that user has access to: Displays only the databases the current user (from the Login Name on the General tab) has access to within the schema browser.
• Use DBA Views:
• Fetch Size: determines the Fetch Size (number of rows physically retrieved from the database at one time by the JDBC driver).
• Connections Pooled: Enables connection pooling. Read more about connection pooling here.
• Data Warehouse Mode: Read Only or Read/Write
• Object Folder Display: [Default], [Name], [Schema].[Name] or [Name]([Schema]) sets how the Schemas will be displayed.

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

Using Driver Properties (Driver Tab)

Edit the Drivers Properties to use Driver Parameters 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 Driver Tab and make changes in the Options.

With options in Driver properties of a Server, you can edit/view the :

• Driver: This displays the JDBC driver used for this connection.
• Driver Parameters: This option is to allow a user to specify extra JDBC parameters that a user might want use in estabilishing a connection.
• Connection URL: This displays the connection URL for this server connection.
• Driver Parameters Quickfilter: This option is to allow a user to search JDBC parameters that a user might want to use in estabilishing a connection.

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.
• Allow SQL debugging for this server connection.

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)

Shell Scripts (FluidShell Tab)

Edit Shell 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 FluidShell Tab and make changes in the Options.

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

• enter a FluidShell Script that is executed each time a new FluidShell connection is established.
• This allows user to cd (change directory) for a server connection. (eg: cd /scripts)