2024-07-22 14:16:36 +00:00
---
id: mssql
2024-09-13 08:32:26 +00:00
title: MS SQL Server / Azure SQL Databases
2024-07-22 14:16:36 +00:00
---
ToolJet can connect to MS SQL Server & Azure SQL databases to read and write data.
2024-09-13 08:32:26 +00:00
< div style = {{paddingTop:'24px'}} >
2024-07-22 14:16:36 +00:00
## Connection
2024-09-13 08:32:26 +00:00
To establish a connection with the MS SQL Server data source, click on the ** + Add new Data source** button located on the query panel or navigate to the [Data Sources ](/docs/data-sources/overview ) page from the ToolJet dashboard.
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
:::info
Please make sure the **Host/IP** of the database is accessible from your VPC if you have self-hosted ToolJet. If you are using ToolJet cloud, please **whitelist** our IP.
:::
2024-07-22 14:16:36 +00:00
ToolJet requires the following to connect to your PostgreSQL database.
- **Host**
- **Port**
- **Username**
- **Password**
2024-09-13 08:32:26 +00:00
- **Azure** (Select this option if you are using Azure SQL databases)
**Note:** It is recommended to create a new database user so that you can control the access levels of ToolJet.
< img className = "screenshot-full" src = "/img/datasource-reference/mssql/connect.png" alt = "ToolJet - Redis connection" / >
< / div >
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
< div style = {{paddingTop:'24px'}} >
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
## Querying SQL Server / Azure SQL Databases
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
1. Click on ** + Add** button of the query manager at the bottom panel of the editor.
2. Select the database added in the previous step as the data source.
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
Once the SQL data source is added, you can create queries to read and write data to the database. You can create queries from the ** [Query Panel ](/docs/app-builder/query-panel#query-manager )** located at the bottom panel of the app builder.
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
### SQL Mode
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
SQL mode can be used to query MS SQL Server / Azure SQL Databases using SQL queries.
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
1. Select **SQL mode** from the dropdown.
2. Enter the SQL query in the editor.
3. Click on the **Run** button to run the query.
2024-07-22 14:16:36 +00:00
2024-09-13 08:32:26 +00:00
#### Example
```sql
SELECT * FROM users
```
< img className = "screenshot-full" src = "/img/datasource-reference/mssql/sql mode.png" alt = "ToolJet mssql sql mode" style = {{marginBottom:'15px'}}/ >
### GUI Mode
GUI mode can be used to query MS SQL Server / Azure SQL Databases without writing queries.
1. Select **GUI mode** from the dropdown.
2. Choose the operation **Bulk update using the primary key** .
3. Enter the **Table** name and **Primary key** column name.
4. In the editor, enter the records in the form of an array of objects.
5. Click on the **Run** button to run the query.
#### Example
```json
{{ [ {id: 1, channel: 33}, {id: 2, channel: 24} ] }}
```
< img className = "screenshot-full" src = "/img/datasource-reference/mssql/gui mode.png" alt = "ToolJet mssql gui mode" / >
2024-07-22 14:16:36 +00:00
:::tip
Query results can be transformed using transformations. Read our transformations documentation to see how: [link ](/docs/tutorial/transformations )
:::
2024-09-13 08:32:26 +00:00
< / div >