Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip
For more information, see Single Sign-On.
Info
Using the Keyboard combination "CTRL + SHIFT + P", you may quickly access Server Properties and edit Tab Coloring options.

...

Image Added

Anchor
filteroptions
filteroptions
Using Filters Options in Registration (Filter Tab)

Edit the Server Properties, to use FILTER options for a Server in Aqua Data Studio:

...

  • Filter Objects: Allows the user to specify the main schema browser filter for object types, on whether to include or exclude 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.

FilterTab.pngImage RemovedImage Added

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 click OK. The Current Connection will be terminated. Reconnect to see the changes.
  • Filters are case-sensitive.
  • Filter Databases works on the list of databases inside the "Databases" folder.
  • Filter Folders works on the list of folders inside a particular database. Example folders: Tables, View, Procedures, etc.
  • Object Folder filter works on individual folders inside a particular database. The user can define filters for each of the Tables, Views, etc. folders.

...

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.

FilterTab2.pngImage RemovedImage Added

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".FilterTab3png.pngImage Removed

Image Added

Anchor
advancedproperties
advancedproperties
Using Advanced Properties (Advanced Tab)

Edit the Server Properties to use Advanced Properties in Aqua Data Studio:

...

  • Transaction 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: Allows JDBC driver to perform escape sequence before sending the SQL code to the server.   
  • Always Display Column Name in Results: Allows showing/hiding column names in query 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.
  • 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.
  • Force Auto-Commit: When this option is selected, it sets auto-commit to TRUE for any Query Window to this server and disables the icons on the toolbar, regardless of the option in File > Options > Query Analyzer > [DATABASE] > [Auto Commit]
  • 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.
  • Object Folder Schema Folder Grouping: Default, Yes or No. Schema Folder Grouping makes finding tables much easier because it groups them instead of showing each object individually.
Info
Using the drop-down at the bottom of the Advanced Tab, quickly change your Object Display in the Server Browser.

...

Image Added

Anchor
drivers
drivers
Using Driver Properties (Driver Tab)

Edit the Drivers Properties to use Driver Parameters in Aqua Data Studio:

...

  • 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 to use in establishing a connection.
  • Connection URL: This displays the connection URL for this server connection.
  • Driver Parameters Quick filter: This option is to allow a user to search JDBC parameters that a user might want to use in establishing a connection.

...

Image Added

Anchor
serverpermissions
serverpermissions
Server Permissions (Permissions Tab)

  Edit the Permissions in Server Properties in Aqua Data Studio:

...

  • 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 behavior of the Table Data Editor for manipulating rows in Tables.
  • Grant / Revoke Alters, Creates, Drops and View Properties of Visual Editing Tools.

...

Image Added

Anchor
serverscripts
serverscripts
Server Scripts (Script Tab)

  Edit Scripts in Server Properties in Aqua Data Studio:

...

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

...

Image Added

Anchor
servershellscripts
servershellscripts
Shell Scripts (FluidShell Tab)

  Edit Shell Scripts in Server Properties in Aqua Data Studio:

...

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

...

Image Added

Anchor
connectionmonitor
connectionmonitor
Server Connections (Connection Monitor Tab)

Enable the connection monitor to start an application thread that monitors the status of the connection associated with the Query Window.
With the connection monitor, you can:

...

For more information, see Connection Monitor.
ConnectionMonitorTab.pngImage RemovedImage Added

Anchor
ssotoken
ssotoken
Active Directory Federation Services Single Sign-On (ADFS SSO)

Enable the Persist SSO Token option so that the Login persists across Aqua Data Studio sessions.

  • Go to File > Options.
  • Expand SSO Options and select Snowflake.
  • Check Persist SSO Token option and click OK.

Image Added OptionsSSO.pngImage Removed
 

  • Right-click the Snowflake database.
  • Select Server Properties.
  • Under the Authentication section, choose SSO Authentication and click Test Connection.
  • A browser will open to the ADFS Login site, fill in your Login information, click Sign in and close the browser window. Your ADFS Login window may look different for your organization.

SSOAuthentication.pngImage RemovedImage Added

 
AquafoldSSOServer.pngImage RemovedImage Added

The ADFS SSO option lets you authenticate with an ADFS identity provider using the Snowflake JDBC and the Snowflake database as the service provider. You have to configure the Snowflake users and set up the IdP within the Snowflake database before using this feature.

Anchor
keypair
keypair
Key Pair Authentication

  • Users need to have a Snowflake login, but a password is not required for this connection.
  • The server administrator provides a private key for the authentication.
  • Before using this feature, the public key has to be added (by an administrator) to the Snowflake database under the login name.
  • Under Snowflake server properties, select Key Pair Authentication.

Snowflake key pair auth.pngImage RemovedImage Added

  • Passphrase is optional for the authentication. Users can add it or leave it blank depending on whether a passphrase was added to the key file.

Snowflake key pair authentication.pngImage RemovedImage Added

Snowflake key pair authentication 3.pngImage RemovedImage Added