2.14 PostgreSQL (Revision #27)

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.

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.

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)

    openssl req -new -text -out server.req           

Fill out the information that openssl asks for. The challengepassword can be left blank. The program will generate a key that ispassphrase protected; it will not accept a passphrase that is lessthan four characters long. To remove the passphrase (as you must ifyou want automatic start-up of the server), run the commands

    openssl rsa -in privkey.pem -out server.key    rm privkey.pem

Enter the old passphrase to unlock the existing key. Now do

    openssl req -x509 -in server.req -text -key server.key -out server.crt    chmod og-rwx server.key

to turn the certificate into a self-signed certificate and copythe key and certificate to the data directory of the server. Nowconvert the server.crt to a format java can import on theclient:

    openssl x509 -in server.crt -out server.crt.der -outform der

Now import the cert into the java keystore:

keytool -keystore [your java home here]/lib/security/cacerts -alias  [any name for cert desired] -import -file server.crt.der

enter the password for the cacerts keystore (default is’changeit’). Say yes to trust this cert.

Make sure your Aqua Data Studio instance knows which keystore touse for the SSL connection by adding to the startup script theparameter-Djavax.net.ssl.trustStore=\lib\security\cacerts

Windows: (Executable) - Modify the[ADS_INSTALL]\datastudio.ini
 - Add to the file vmarg.2=-Djavax.net.ssl.trustStore=\lib\security\cacerts"

Windows: (Batch) - Modify the [ADS_INSTALL]\datastudio.bator datastudio-bundled.bat
 - Last line should execute java with the parameter between"java" and "-cp" such as ...
"java -Djavax.net.ssl.trustStore=\lib\security\cacerts-cp"

OSX: - Modify /Aqua Data Studio/Contents/Info.plist

> ..>
>    VMOptions
>
> -Djavax.net.ssl.trustStore=/Library/Java/Home/lib/security/cacerts
> -Xmx256m
>     MainClass
>     com.aquafold.datastudio.DataStudio
> ...