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

# Microsoft SQL Server Connector

## Intro

Microsoft SQL Server is a repository for your business information, but you need to provide easy access to critical metrics. Domo connects directly to SQL Server and delivers the information you need in real-time visualizations that make analysis easier. Moreover, you can see SQL Server data alongside metrics from any other system, all in a single platform, and get instant notifications when your SQL Server metrics hit thresholds that you determine. Using the Domo Microsoft SQL Server connector, you can query data from your SQL Server using standard SQL queries. Once your data is in Domo, you can collaborate with your team where your data lives—so nothing gets lost in translation. Stop waiting days or weeks for reports. With real-time MSSQL data, you can have confidence in the metrics you share with stakeholders.

**Microsoft SQL Server** is a [relational database management system](http://en.wikipedia.org/wiki/Relational_database_management_system "Relational database management system") developed by [Microsoft](http://en.wikipedia.org/wiki/Microsoft "Microsoft"). As a database, it is a software product whose primary function is to store and retrieve data as requested by other software applications, be it those on the same computer or those running on another computer across a network (including the Internet).

You can connect to your Microsoft SQL Server in the Data Center. This article explains the fields and menus specific to the Microsoft SQL Server connector user interface. To add DataSets, set update schedules, and edit DataSet information, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to a Microsoft SQL Server database and create a DataSet, you must have the following:

* Username
* Password
* Host
* Port
* Database
* Certificate (optional)
* Additional JDBC Properties (optional)

Before you can connect to your SQL server, 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](https://domo-support.domo.com/s/article/360043439173?language=en_US "Whitelisting IP Addresses for Connectors").

## Connect to Your Microsoft SQL Server Database

This section enumerates the options in the **Credentials** and **Details** panes in the Microsoft SQL Server 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 Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your 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> Field </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> MS SQL Username </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Database password </p></td></tr><tr><td colspan="1" rowspan="1"><p> Host </p></td><td colspan="1" rowspan="1"><p><span> Database hostname </span></p><p><code /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Port </p></td><td colspan="1" rowspan="1"><p> Database port number </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database </p></td><td colspan="1" rowspan="1"><p><span> SSL CA Certificate download url </span></p><p><code /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Certificate </p></td><td colspan="1" rowspan="1"><p> Enter the comma separated additional JDBC properties here. <br /><b> Example: </b> property1=value1,property2=value2 </p></td></tr></tbody></table>

Once you have entered valid Microsoft SQL Server credentials, you can use the same account any time to create a new Microsoft SQL DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

## Details Pane

In this pane you create an SQL query to pull data from your database.

<table border="1" data-aura-rendered-by="33:195;a"><tbody><tr><td colspan="1" rowspan="1"><b> Menu </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Query Type </td><td colspan="1" rowspan="1"><p> Select a query type. </p><table border="1"><tbody><tr><th colspan="1" rowspan="1"> QueryType </th><th colspan="1" rowspan="1"> Description </th></tr><tr><td colspan="1" rowspan="1"> Custom Query </td><td colspan="1" rowspan="1"><p> Enter the SQL query to execute. When you select the query types as <b> Custom Query </b>, the following fields populate: </p><ul><li> Query </li><li> Query Parameter (checkbox) </li><li> Fetch Size </li><li> Query Parameter </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Query Builder </td><td colspan="1" rowspan="1"><p> Select a table and fields to autogenerate your query. When you select the query types as <b> Query Builder </b>, the following fields populate: </p><ul><li> Fetch Size </li><li> Database Tables </li><li> Table Columns </li><li> Query </li></ul></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Fetch Size (optional) </td><td colspan="1" rowspan="1"> Enter the fetch size, which is the number of rows requested for each page of data. 10,000 rows is the recommended maximum fetch size. If your dataset throws an out of memory error, try decreasing the fetch size. </td></tr><tr><td colspan="1" rowspan="1"> Database Tables </td><td colspan="1" rowspan="1"> Select the table. </td></tr><tr><td colspan="1" rowspan="1"> Table Columns </td><td colspan="1" rowspan="1"> Select the columns. </td></tr><tr><td colspan="1" rowspan="1"> Query </td><td colspan="1" rowspan="1"> When you select any table column, the corresponding query appears. in this field. <b> Note: </b> This field appears when you select the Query Type as <b> Query Builder </b>. </td></tr><tr><td colspan="1" rowspan="1"> Query </td><td colspan="1" rowspan="1"> Enter the SQL query to execute. The query gets executed on the MySQL server and fetches the data. <b> Note: </b> This field appears when you select the Query Type as <b> Custom Query </b>. </td></tr><tr><td colspan="1" rowspan="1"> Query Parameter (checkbox) </td><td colspan="1" rowspan="1"> Select this checkbox to add query parameters. </td></tr><tr><td colspan="1" rowspan="1"> Query Parameter </td><td colspan="1" rowspan="1"> Enter the query parameter value, which is the initial value for query parameter. The last run date is optional by default and the date is '02/01/1700' if is not provided. For example: <tt> `!{lastvalue:_id}!=1,!{lastrundate:start_date}!=02/01/1944` </tt></td></tr><tr><td colspan="1" rowspan="1" /><td colspan="1" rowspan="1" /></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 Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").
