---
title: "Microsoft SQL Server"
canonical: "https://wiki.yellowfinbi.com/space/yfcurrent/2195858/Microsoft%20SQL%20Server"
format: markdown
---
Follow the instructions below to connect Yellowfin to a **Microsoft SQL Server** database.

1. Click on the **Create** button and choose the data source option.  
> Macro (inline-media-image)

  
<span style="color: #000000">2. Select </span>**<span style="color: #000000">Microsoft SQL Server</span>****<span style="color: #000000"> </span>**<span style="color: #000000">from the databases list.</span>  
> Macro (inline-media-image)

  
3. When the New Connection popup appears, provide a name and description for your database.  
4. **Connection String: **when selecting Connection String you have the same functionality as in [Generic JDBC Data Source](https://yellowfin.atlassian.net/wiki/display/yfcurrent/Generic+JDBC+Data+Source)**.**  
> Macro (inline-media-image)

  
<span style="color: #000000">5. </span>**<span style="color: #000000">Microsoft SQL Server </span>**<span style="color: #000000"> configuration fields:</span>  
> Macro (inline-media-image)

  
5. Select the **Include Schema in SQL** checkbox to include the schema name when addressing database tables in SQL queries.   
6. Next, enter the name or IP address of the server hosting the SQL server database.  
7. From the Driver drop-down list, select one of the two drivers available for the SQL server.  
> Macro (inline-media-image)

  
8. Next, specify if you want to create a default instance or a named instance of SQL Server. If an instance of Microsoft SQL Server is not already installed then a default one will be created, unless a named instance has been specified.   To specify a named instance, first select the **Use Named Instance** checkbox, and then enter the name of the instance in the new field.  
> Macro (inline-media-image)

  
9. The default TCP/IP port number for the SQL server database will automatically appear.  
10. Specify the name of the database containing the data that you require.  
11. From the Database Authentication list, choose an authentication method for the database. On selecting the **Windows Authentication** method, you will need to provide the domain name as well.  
> Macro (inline-media-image)

  
12. From the SSL dropdown list, choose whether or not the Secure Sockets Layer should be enabled to encrypt data.  
13. Select the **Use Custom Fetch Size** checkbox if you want a specific number of data rows to be retrieved from the database after a query is executed, rather than fetching its entire result. Then specify the number of rows in the *Fetch Size* field. Doing so will allow Yellowfin to process data faster.  
> Macro (inline-media-image)

  
14. The selected JDBC driver option appears based on your selection in step 7.   
> Macro (inline-media-image)

  
15. Enter the username and password of your SQL server database account.  
<span style="color: #000000">16. Toggle Advanced Settings</span><span style="color: #000000"> to see more settings.</span>  
> Macro (inline-media-image)

  
17. Once you have completed your connection information, you will have several options:  
> Macro (inline-media-image)



> Macro (legacy-content)