You can create connections to one or more  databases from 


If you are connecting to any relational source of data, such as or , you must add the to your whitelist for those resources.For more information, see Getting Started with Trifacta.

Supported Versions: 12.0.4



Configure

To create this connection:

Modify the following properties as needed:

PropertyDescription
Host
Enter your hostname. Example:

 

testsql.database.windows.net
PortSet this value to 1433.
Connect String options

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

User Name(basic credential type only) Username to use to connect to the database.
Password(basic credential type only) Password associated with the above username.
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.

Test ConnectionAfter you have defined the connection credentials type, credentials, and connection string, you can validate those credentials.
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  to the connection:

jdbc:sqlserver://<host>:<port>;<prop1>=<val1>;<prop2>=<val2>

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:

delimiters:

Example connect string options

The following connect string contains several options. Please insert as a single string (no line breaks):

;database=<database_name>;encrypt=true;trustServerCertificate=false;
hostNameInCertificate=*.database.windows.net;loginTimeout=30;

Common connect string properties:

PropertyDescription
databaseSet this value to <database_name>, the name of the database to which to connect.
encrypt

Set this value to true. Encrypted communication is required.

trustServerCertificate

When set to true, the does not validate the SQL Server TLS/SSL certificate. Default value is false.

hostNameInCertificate

Defines the host name in the server certificate.

NOTE: Do not modify this value unless required.

loginTimeout

Number of seconds that the attempts to login to the database server. Default is 30.

Delimiters:

Authentication options

Driver Information

This connection uses the following driver:

Create via API

This connection can also be created using the API. 

For more information, see 

#operation/createConnection

Troubleshooting

Error messageDescription

“The TCP/IP connection to the host <hostname>, port <port> has failed”

The host is not accessible.

Please verify that the correct IP addresses have been whitelisted on the SQL Server instance. For more information, see Getting Started with Trifacta.

"Login failed for user '<username>'."

Permission denied. Please verify your credentials.

Tip: Click the Test Connection button to check the connection credentials.

"The certificate received from the remote server was issued by an untrusted certificate authority"

There was an issue with the trusted certificate on the SQL Server instance.

To disable validation of the certificate, add the following to the connection string options:

;trustServerCertificate=true;

Use

SQL Syntax

The following syntax requirements apply to this connection.

Object delimiter: none

Example syntax:

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


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

For more information, see Database Browser.

Data Conversion

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