Skip to main content

Microsoft SQL

Microsoft SQL Server, often referred to as MS SQL Server is a relational database management system (RDBMS) developed by Microsoft that allows you to perform different actions like storing and retrieving data to and from the databases.

Configuring Connector


  1. Authentication Credentials: Obtain the required credentials to connect to your MS SQL instance. You will need the following credentials:

    • MS SQL database username and password.
  2. Connection Details:

    • Hostname or IP address of the MS SQL server.
    • Port number for database access.
    • Database name within the MS SQL server.
  3. Firewall Rules:

    • Configure firewall settings to allow DronaHQ (IP whitelist) access to your MS SQL server.

Ensuring these prerequisites are met will ensure a seamless integration of MS SQL with DronaHQ, facilitating effective data management and utilization.

Connector Setup in DronaHQ

Configure your database category by providing the details below. Validate the connection using Test connection and Save settings for a secure and efficient database setup.


DronaHQ can Auto fill crucial connection values like host, name, password, and more from the connector's connection string or from a AWS IAM credentials using AWS Import.


HostEnter the Host Domain or IP
PortEnter the Port number
Database NameEnter the Database name
UsernameEnter the Username
PasswordEnter the Password
MS SQL with Sample details.
MS SQL with Sample details.


Microsoft SQL – TDS Version

When configuring the Microsoft SQL connector in DronaHQ, users can choose the Tabular Data Stream (TDS) protocol version. TDS facilitates communication between clients and database servers. DronaHQ DronaHQ provides multiple TDS versions for compatibility, allowing users to select as needed.

SQL Server Proxy Host

In DronaHQ's Microsoft SQL connector setup, the SQL server proxy host can be specified. This feature establishes a secure gateway between the client and the target SQL server, enabling access to external SQL resources using distinct credentials. It offers controlled execution of Windows shell commands and SQL Server Agent jobs to enhance security and operational control.

Advanced OptionDescription
Connection OptionsThe key and value connection options in the database configuration refer to specific settings (keys) and their corresponding values that dictate how the application connects to the database
TDS VersionChoose the Tabular Data Stream (TDS) protocol version for communication with the MS SQL server.
SQL Server Proxy HostSpecify the proxy host to route the MS SQL connection through a proxy server, if necessary.
Use Dynamic Database HostDynamically determine the host for the database connection.
Use Dynamic Database NameSet the database name dynamically, allowing easy switching between databases.
Use Dynamic Database Credentials Enable dynamic database credentials for secure and convenient management.
Enable Converting Queries to Prepared Statement Opt for prepared statements to enhance database performance and security.
Connect using SSL Securely access the database using an encrypted SSL connection, ensuring data integrity and confidentiality.
Enable SSH Tunneling Securely access the database through encrypted SSH tunneling.
Whitelist IP Enhance security by restricting database access to specific whitelisted IP addresses.

Adding Database Queries

After configuring the connector, access it in your Connector Library.

Click Add query once the connection is established. Create queries, run them, and view responses.

Write Queries
Write Queries

Use double curly brackets for dynamic variables. Test with sample values before saving. Link dynamic variables to controls/actions for runtime use.

Saved queries appear under your connector in Connector Library.

Supported Query Operations

Raw SQL QueryExecute various SQL operations directly, e.g., SELECT * FROM TableName;
Stored Procedure CallCall stored procedures, e.g., EXEC usp_GetInfo; to perform specific tasks or retrieve data from the database.

Using Microsoft SQL Connector

Data Bind using Data Query

Read/Display Data Query for Microsoft SQL:

Start by constructing an SQL query to retrieve data from your Microsoft SQL database. For instance, let's consider an example where you want to retrieve all data from the auth_permission table. The SQL query is:

Query used:

SELECT * FROM auth_permission;

Query explanation:

This SQL query retrieves all rows and columns from the auth_permission table.

Get all data query with added pagination.
Get all data query with added pagination.

Integrate the fetched data into your application's interface.

a. Access the Controls section and introduce the Table grid control.

b. Navigate to Data Bind Options -> Quick Select -> Database Queries.

c. Opt for the Microsoft SQL connector and choose the query that aligns with your data presentation goals.