> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Synapse SQL Connector

<Warning>
  All Azure SQL Data Warehouse datasets will continue to run as normal. The functionality of the connector has not been changed.

  Customers using or planning to use the connector will notice the following:

  1. There is a new icon for the connector in the Appstore.  Existing datasets will now show up on the Data Center with the new icon.
  2. Customers who are trying to search for an Azure Data Warehouse dataset in the Data Center using a ‘Type’ filter will now need to search for datasets of type ‘Azure Synapse SQL’ instead of ‘Azure Data Warehouse’.
  3. Customers who want to create a new Azure SQL Data Warehouse will need to search the Appstore for the ‘Azure Synapse SQL Connector’ instead of the ‘Azure SQL Data Warehouse Connector.’
  4. Connector Accounts for the Azure SQL Data Warehouse Connector will now be called ‘Azure Synapse SQL’ Accounts.
</Warning>

## Intro

Azure Synapse SQL lets you quickly implement a high-performance, globally available, and secure cloud data warehouse. Use Domo's Azure Synapse SQL Connector to bring your Azure data into Domo.

You connect to your Azure Synapse SQL database in the Data Center. This topic discusses the fields and menus that are specific to the Azure Synapse SQL Connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Prerequisites

To connect to an Azure Synapse SQL database and create a DataSet, you must have the following:

* The username and password you use to log into your Azure Synapse database.
* The server name for the database. You can find this by doing the following:

  1. Log into Azure Portal.
  2. Click on **Azure Synapse Analytics**.
  3. Click on the Synapse SQL Pool you want to connect to.
  4. Locate the full server name. Example **[yourserver.database.windows.net](http://yourserver.database.windows.net)**
* The port number for the database
* The database name

Before you can connect to an Azure Synapse SQL database, you must also whitelist a number of IP addresses on your database server on the port you want to connect to. For the full list of IP addresses, see [Whitelisting IP Addresses for Connectors](/s/article/360043630093 "Whitelisting IP Addresses for Connectors").

## Connecting to Your Azure SQL Database

This section enumerates the options in the **Credentials** and **Details** panes in the Azure Synapse SQL Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Azure Synapse SQL database. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> JDBC Driver </p></td><td colspan="1" rowspan="1"><p> Select the JDBC driver you want to use from the drop-down list. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Server Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of your server. For information about finding the server name, see "Prerequisites," above. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the Azure Synapse database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Port </p></td><td colspan="1" rowspan="1"><p> Enter the port number for the Azure Synapse database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter the username you use to log into your Azure Synapse database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Enter the password you use to log into your Azure Synapse database. </p></td></tr><tr><td colspan="1" rowspan="1"><p><span><span dir="ltr"> Hostname in Certificate </span></span></p></td><td colspan="1" rowspan="1"><p> Enter the h <span><span dir="ltr"> ostname in certificate </span></span> obtained from the show database connection strings. </p></td></tr></tbody></table>

Once you have entered valid credentials, you can use the same account any time you go to create a new Azure Synapse SQL DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector Accounts").

### Details Pane

In this pane you create an SQL query to pull data from your database. The **Query** parameter is required. The other three parameters are here to help you construct this query, if you choose.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Query Type (Mandatory) </p></td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><td colspan="1" rowspan="1"><b> Query Type </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Custom Query </td><td colspan="1" rowspan="1"> Enter the query to execute. </td></tr><tr><td colspan="1" rowspan="1"> Query Builder </td><td colspan="1" rowspan="1"> Select a table and fields to autogenerate your query. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Query (Mandatory) </p></td><td colspan="1" rowspan="1"><p> Enter the Structured Query Language (SQL) query to use in selecting the data you want. For example: </p><p><span class="mt-font-courier-new"> select \* from Employee </span></p><p> If you want help in constructing your query, copy and paste the automatically-generated query from the <b> Query Helper </b> field into this field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database Tables (Mandatory) </p></td><td colspan="1" rowspan="1"><p> Select the table containing the data you want to pull into Domo. The selected table will be added to the automatically generated query in the <b> Query Helper </b> field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Table Columns (Mandatory) </p></td><td colspan="1" rowspan="1"><p> Select the table columns with data you want to pull into Domo. The selected columns will be added to the automatically generated query in the <b> Query Helper </b> field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Query Helper (Mandatory) </p></td><td colspan="1" rowspan="1"><p> Copy and paste this query into the <b> Query </b> field if you need in help building a query. This query is automatically generated when you select a table and columns in the <b> Database Table </b> and <b> Table Columns </b> fields, respectively. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Limit Buffer Size </p></td><td colspan="1" rowspan="1"><p> Select the checkbox if you want to limit the maximum heap memory used by ResultBuffer. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Convert BIGINT to LONG </p></td><td colspan="1" rowspan="1"><p> Select this check box if you want to convert the BIGINT columns to LONG. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").
