AlloyDB Connections
You can create connections to a Alloy DB database from Alteryx Analytics Cloud (AAC). For more information on Alloy DB, go to https://www.postgresql.org/.
Tip
This connection is in early preview. It is read-only and available only in SaaS product editions. For more information on early previews, go to Early Preview Connection Types.
If you are connecting AAC to any relational source of data, such as Redshift or Oracle, you must add the Alteryx Service to your allowlist for those resources. For more information, go to Allowlist Platform Service.
Supported Versions: 9.3.10
Read: Supported
Write: Supported
Configure
To create this connection:
On the Import Data page, select the Plus sign. Then, select the Relational tab. Select the Alloy DB card.
You can also create connections through the Connections Page.
Modify these properties as needed:
Property | Description |
---|---|
Host | Enter your fully qualified hostname. Example: my.postgres.server |
Port | Set this value to |
Connect String Options | Insert any additional connection parameters, if needed. |
Enable SSL | Check the box to enable SSL connections to the database. Note The database server might require additional configuration. For more information, please consult the distribution documentation. |
Database | Enter the name of the database on the server to which to connect. |
User Name | Username to use to connect to the database. |
Password | Password associated with the above username. |
Test Connection | After you've defined the connection credentials type, credentials, and connection string, you can validate those credentials. |
Advanced options: Default Column Data Type Inference | Set to |
Advanced options: Enable SSH Tunneling | If available, use the SSH tunneling options to configure SSH tunneling authentication between AAC and your database. Note SSH tunneling is available on a per-connection basis. It might not be available for all connections. For more information, go to Configure SSH Tunnel Connectivity. |
Connection Name | Display name of the connection. |
Connection Description | Description of the connection that appears in the application. |
Connection URL
AAC builds the connection URL from the properties you provided:
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 this 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
The AlloyBD connection uses this driver:
Driver name:
org.postgresql.Driver
Driver version:
org.postgresql:postgresql:42.1.1
Driver documentation:https://jdbc.postgresql.org/documentation/head/index.html
Create via API
You can also use the API to create this connection:
Type:
jdbc
Vendor:
postgres
Troubleshooting
Error Message | Description |
---|---|
Class 08 Connection Exception | Connection failure: the web client or Trifacta node is unable to establish a connection. |
Class 28 Invalid Authorization Specification | Typically, this error occurs when a user submits an invalid password. Tip Use the Test Connection button to validate your credentials. |
For more information on error messages for this connection type, go to https://www.postgresql.org/docs/9.3/errcodes-appendix.html.
Note
Please note the version number in the URL above.
Use Connection
For more information, go to Database Browser.
For more information on interacting with data, go to Using Databases.
SQL Syntax
These syntax requirements apply to this connection:
Object delimiter: double-quote
Example syntax:
Double quotes are required around database, table names, and column names.
SELECT "column1","column2" FROM "databaseName"."tableName";
For more information on SQL in general, go to Supported SQL Syntax.
Data Conversion
For more information on how AAC converts values during input and output with this database, go to Postgres Data Type Conversions.