This section describes how to create connections to  (DW).

Tip: This connection is now known as Azure Synapse Analytics.

Supported Versions: n/a

Supported Environments:


AmazonMicrosoft Azure
ReadNot supportedNot supportedSupported
WriteNot supportedNot supported


NOTE: Additional configuration is required.



Connection Types

The supports two types of connections to an Azure SQL DW data warehouse:

Connection TypeDescriptionNotes
SQL DW Read-Only

Read-only access to the . This connection is available on the Import Data page only.

To create, see Import Data Page.

This connection requires fewer permissions on the data warehouse and its databases but is less performant.

SQL DW Read-Write

Read-write access to the . This connection is available for reading, direct publishing, and ad-hoc publishing.

NOTE: Under Azure SSO, write operations are not supported through SQL DW connections.

To create, see Connections Page.

This connection requires more permissions. You must also specify an External Datasource Name. See below.

Tip: Spark-based jobs that read or write through your SQL DW connection leverage PolyBase for faster performance.


 External Data Source Name

When specifying a SQL DW Read-Write connection, you can provide an External Data Source Name value as part of the connection definition. The External Data Source enables publishing and support for large-scale data ingestion. 

NOTE: This setting is not used for Read-Only connections.

If the External Data Source is not provided:



To create this connection:

Please create a connection of this type in the appropriate page and modify the following properties with the listed values:

Enter your hostname. Example:
PortSet this value to 1433.
DatabaseSet this value to the default database name.
External Data Source NameFor read-write connections, you must provide an External Data Source. Otherwise, the connection is read-only. See above for details.
Connect String options

Include any options required for your environment:

User NameUsername to use to connect to the database.
PasswordPassword associated with the above username.
Credential Type
  • basic - Specify username and password as part of the connection
  • Azure Token SSO - Use the SSO principal of the user creating the connection to authenticate to the SQL Server database. Additional configuration is required. See Enable SSO for Azure Relational Connections.
Default Column Data Type Inference

Set to disabled to prevent the from applying its own type inference to each column on import. The default value is enabled.

Configure for SSO

If you have enabled Azure AD SSO integration for the , you can create SSO connections to Azure relational databases. 

NOTE: When Azure AD SSO is enabled, write operations to are not supported.

See Enable SSO for Azure Relational Connections


For more information on locating data, see Database Browser.

For more information, see Using SQL DW.

Data Conversion

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