Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r0821


D toc

You can create connections to one or more PostgreSQL databases from

D s product
rtrue
. For more information on PostgreSQL, see https://www.postgresql.org/.

Pre-requisites

Warning

If the

D s item
databases
databases
are hosted on a PostgreSQL server, do not create a connection to this database.

  • If you haven't done so already, you must create and deploy an encryption key file for the 
    D s node
     to be shared by all relational connections. For more information, see Create Encryption Key File

Configure

To create this connection:

  • In the Import Data page, click the Plus sign. Then, select the Relational tab. Click the PostgreSQL card. 
  • You can also create connections through the Connections page. See Connections Page.

For additional details on creating a PostgreSQL connection, see Enable Relational Connections.

This connection can also be created using the API. 

Modify the following properties as needed:

PropertyDescription
Host
Enter your fully qualified hostname. Example:

 

Code Block
my.postgres.server
PortSet this value to 5432.
Connect String Options

Insert any additional connection parameters, if needed. See below.

Enable SSL

Select the checkbox to enable SSL connections to the database.

Info

NOTE: Additional configuration may be required in the database server. For more information, please consult the documentation that was provided with the distribution.


DatabaseEnter the name of the database on the server to which to connect.
User NameUsername to use to connect to the database.
PasswordPassword associated with the above username.
Test ConnectionAfter you have defined the connection credentials type, credentials, and connection string, you can validate those credentials.
Default Column Data Type Inference

Set to disabled to prevent the platform from applying its own type inference to each column on import. The default value is enabled.

Connection NameDisplay name of the connection
Connection DescriptionDescription of the connection, which appears in the application.

Reference

Connection URL

The properties that you provide are inserted into the following URL, which connects 

D s product
 to the connection:

Code Block
jdbc:postgresql://<host>:<port>/<database><connect-string-options>

Connect string options

The connect string options are optional. If you are passing additional properties and values to complete the connection, the connect string options must be structured in the following manner:

Code Block
?<prop1>=<val1>&<prop2>=<val2>...

where:

  • <prop> : the name of the property
  • <val> : the value for the property

delimiters:

  • ? : any set of connect string options must begin with a question mark.
  • &all additional property names must be prefixed with an ampersand (&).
  • =property names and values must be separated with an equal sign (=).

Driver Information

This connection uses the following driver:

Troubleshooting

Error messageDescription
Class 08 Connection Exception

Connection failure: the web client or

D s node
is unable to establish a connection.

Class 28 Invalid Authorization Specification

Typically, this error occurs when an invalid password has been submitted.

Tip

Tip: Use the Test Connection button to validate your credentials.

For more information on error messages for this connection type, see https://www.postgresql.org/docs/9.3/errcodes-appendix.html.

Info

NOTE: Please note the version number in the URL above.

Use

For more information, see Database Browser.

For more information on interacting with data, see Using Databases.

Data Conversion

For more information on how values are converted during input and output with this database, see Postgres Data Type Conversions.