Create SQL Server Connections

Contents:

Expand all Collapse all

Contents:

You can create connections to one or more Microsoft SQL Server databases from Designer Cloud Enterprise Edition.

Pre-requisites

If you haven't done so already, you must create and deploy an encryption key file for the Alteryx node to be shared by all relational connections. For more information, see Create Encryption Key File.
If you plan to create an SSO connection of this type, additional configuration may be required. See Enable SSO for Relational Connections.

To create this connection:

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

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

This connection can also be created using the API.

Modify the following properties as needed:

Property	Description
Host	Enter your hostname. Example: testsql.database.windows.net
Port	Set this value to `1433`.
Connect String options	Please insert the following as a single string (no line breaks): ;database=<DATABASE_NAME>;encrypt=true;trustServerCertificate=false; hostNameInCertificate=*.database.windows.net;loginTimeout=30; where: `<DATABASE_NAME>` is the name of the SQL database to which you are connecting
Credential Type	Options: `basic` - (default) You provide the username and password to use as part of the connection definition. `Kerberos delegate` - Connection uses the Kerberos-delegated principal to connect to the database. No credentials are submitted as part of the connection definition. This method requires additional configuration. See Enable SSO for Relational Connections.
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 Designer Cloud Powered by Trifacta platform from applying its own type inference to each column on import. The default value is `enabled`.
Test Connection	After you have defined the connection credentials type, credentials, and connection string, you can validate those credentials.
Connection Name	Display name of the connection
Connection Description	Description of the connection, which appears in the application.

For more information, see Database Browser.

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