Page tree


Contents:

Our documentation site is moving!

For up-to-date documentation of Dataprep, please visit us at https://help.alteryx.com/Dataprep/.

   

Contents:


Feature Availability: This feature may not be available in all product editions. For more information on available features, see Compare Editions.

You can create connections to a Alloy DB database from Dataprep by Trifacta application. For more information on  Alloy DB, see https://www.postgresql.org/.

Tip: You can create connections to databases of this type that are managed by your enterprise or are hosted in cloud infrastructure. The required configuration is the same. The cloud-based version is labeled on Cloud SQL. In the Create Connection dialog, you can search for that term.

If you are connecting the Dataprep by Trifacta Cloud  to any relational source of data, such as Redshift or Oracle, you must add the Dataprep by Trifacta Service to your whitelist for those resources. See Whitelist Platform Service.

Supported Versions: 9.3.10

  • Read: Supported
  • Write: Supported

Configure

To create this connection:

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

Modify the following properties as needed:

PropertyDescription
Host
Enter your fully qualified hostname. Example:


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.

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.
Advanced options: 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.

Advanced options: Enable SSH Tunneling

If available, the SSH tunneling options allow you to configure SSH tunneling authentication between the Dataprep by Trifacta application and your database.

NOTE: SSH tunneling is available on a per-connection basis. It may not be available for all connections.

For more information, see Configure SSH Tunnel Connectivity.


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

Connection URL

The properties that you provide are inserted into the following URL, which connects Dataprep by Trifacta Cloud to the connection:

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:

?<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:

Create via API

This connection can also be created using the API. 

  • Type: jdbc
  • Vendor: postgres

For more information, see Dataprep by TrifactaAPI Reference docs

Troubleshooting

Error messageDescription
Class 08 Connection Exception

Connection failure: the web client or Alteryx node is unable to establish a connection.

Class 28 Invalid Authorization Specification

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

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.

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.

SQL Syntax

The following syntax requirements apply to this connection.

Object delimiter: double-quote

Example syntax:

Double quotes required around database, table names, and column names.

SELECT "column1","column2" FROM "databaseName"."tableName";

For more information on SQL in general, see Supported SQL Syntax.

Data Conversion

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

This page has no comments.