You can create connections to one or more Microsoft SQL Server databases from

Pre-requisites

• 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. 

• If you plan to create an SSO connection of this type, additional configuration may be required. See Enable SSO for Relational Connections.

Configure

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. 

• For details on values to use when creating via API, see Connection Types.
• See API Reference.

testsql.database.windows.net

Reference

Connection URL

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

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:

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

delimiters:

• ; : any set of connect string options must begin and end with a semi-colon. 
• = : property names and values must be separated with an equal sign (=).

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:

Delimiters:

• ; : any set of connect string options must begin and end with a semi-colon.
• ; : all additional property names must be prefixed with a semi-colon.
• = : property names and values must be separated with an equal sign (=).

Authentication options

Kerberos:

You can use kerberos security for connecting to the database server. Additional configuration is required:

• For more information on enabling single-sign on for databases, see Enable SSO for Relational Connections.
• The SSO solution for databases leverages the platform's integration with cluster kerberos. For more information, Configure for Kerberos Integration.

Driver Information

This connection uses the following driver:

• Driver name: com.microsoft.sqlserver.jdbc.SQLServerDriver

• Driver version: com.microsoft.sqlserver:mssql-jdbc:7.2.2.jre8
• Driver documentation: 
  • Overview: https://docs.microsoft.com/en-us/sql/connect/jdbc/overview-of-the-jdbc-driver?view=sql-server-ver15
  • Connection URL: https://docs.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?view=sql-server-ver15
  • Connection properties: https://docs.microsoft.com/en-us/sql/connect/jdbc/setting-the-connection-properties?view=sql-server-ver15

Troubleshooting

;trustServerCertificate=true;

Use

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.