Database Connection
BonData connects to Azure Synapse Analytics over the TDS protocol using standard SQL authentication, the same way you would connect to a SQL Server database.Step 1: Locate Your SQL Endpoint
- Open the Azure Portal and go to your Synapse workspace
- On the Overview page, find the SQL endpoint under Dedicated SQL endpoint
- The endpoint has the format
<workspace-name>.sql.azuresynapse.net
Connect to the dedicated SQL pool endpoint (
*.sql.azuresynapse.net), not the serverless (*-ondemand.sql.azuresynapse.net) endpoint, unless you specifically intend to query serverless external tables.Step 2: Configure Firewall Rules
- In your Synapse workspace, go to Networking (or Firewalls and virtual networks)
- Add BonData’s IP addresses to the allowed IP range
- Ensure Allow Azure services and resources to access this workspace is configured as required by your security policy
- Save the changes
Step 3: Create a SQL Login and User (Recommended)
For security, create a dedicated read-only user for BonData in your dedicated SQL pool:Step 4: Gather Connection Details
Collect the following information:- Host: Your workspace SQL endpoint (e.g.,
myworkspace.sql.azuresynapse.net) - Port:
1433 - Database: The name of your dedicated SQL pool
- User: The username created above
- Password: The password for the user
Step 5: Connect in BonData
Enter your connection details in BonData to establish the connection.Required Fields
Azure Synapse requires encrypted connections. BonData connects using SQL authentication over an encrypted channel by default.
Available Data
Once connected, BonData can sync:- Tables - All tables the user has SELECT access to
- Views - Database views accessible to the user
- Custom Queries - Run custom T-SQL queries to extract specific data