Search

Azure Synapse

Azure Synapse

Setup Guide

Follow these steps to connect Azure Synapse to your CData Connect Cloud account:

  1. Open the Connections page of the CData Connect Cloud dashboard.

  2. Click + Add Connection in the upper-right corner.

  3. Type Azure Synapse into the search field, then click the data source name.

  4. On the Basic Settings tab of the new connection, enter a connection name or keep the default name.

Authentication Methods

Password

  1. Enter the following information:

    • The User and Password for Azure Synapse.

    • Port—the port for connecting to the Azure Synapse server.

    • Server—the host name or IP address of the Azure Synapse server.

    • Database—(optional) the name of the Azure Synapse database.

  2. At the top of the CData Connect Cloud Add Azure Synapse Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

AzureAD

  1. Enter the following information:

    • Port—the port for connecting to the Azure Synapse server.

    • Server—the host name or IP address of the Azure Synapse server.

    • Database—(optional) the name of the Azure Synapse database.

  2. At the top of the CData Connect Cloud Add Azure Synapse Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

AzureServicePrincipal

  1. Enter the following information:

    • Azure Tenant—the Microsoft Online tenant that you use to access data.

    • OAuth Client Id—the Id assigned when you registered your Azure Synapse account for OAuth.

    • Either the OAuth Client Secret for your Azure Synapse account for OAuth OR the OAuth JWT Cert multi-line key in PEM format. Follow the format shown.

    • Port—the port for connecting to the Azure Synapse server.

    • Server—the host name or IP address of the Azure Synapse server.

    • Database—(optional) the name of the Azure Synapse database.

  2. At the top of the CData Connect Cloud Add Azure Synapse Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created. The Status on the Edit Connection page also changes to Authenticated.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. CData Connect Cloud displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.

More Information

For more information about interactions between CData Connect Cloud and Azure Synapse, see this information page.