This guide will walk you through how to log into the Supermetrics Azure Synapse data source.
Before you begin
- The Azure Synapse data source only supports oAuth logins. This means the user needs a Microsoft user or business account that has access to an Azure Synapse database/data warehouse.
- That account should have at least SELECT permissions to the database/data warehouse they want to pull data from. An Azure administrator should ensure the permissions are set up correctly.
- The database that will be used will also need to have some IPs allowlisted in order to allow Supermetrics to connect.
Instructions
- Log in to Azure.
- Enter “sql databases" in the search box at the top of the page.
- Select SQL databases from the dropdown. Click the database that you want to connect to. If you don’t see the database listed on the page, ask an Azure administrator to give you access.
- A panel will open with database details. Enter “query editor” in the search box and select Query editor (preview).
- A new login page will open. On the right side under Active Directory authentication, select Continue as....
- If you can open the query editor, then you should have the database access needed to connect Supermetrics to Azure Synapse. If you can't use the query editor, ask an Azure administrator to give you access.
To connect Supermetrics to Azure Synapse, you’ll first need to gather your:
- Tenant ID
- Workspace name
- Database name
Tenant ID
You can acquire the Tenant ID either by checking with the Azure administrator, or by opening Microsoft Azure, and then searching for and clicking Tenant properties in the top search bar.
When you find it, copy the Tenant ID from the list of properties.
Workspace name
You can find the workspace name (also called the server name) either by checking with your Azure administrator, or by looking up the SQL server list in the Microsoft Azure portal.
Do this by opening Microsoft Azure and then searching for and clicking on SQL servers in the top search bar.
When you find the list of servers, copy the name of the server you want to query.
Database name
You can find the workspace name (also called the server name) either by checking with your Azure administrator, or by looking up the SQL server list in the Microsoft Azure portal.
Do this by opening Microsoft Azure and then searching for and clicking on SQL databases in the top search bar.
The name column should have both the database name and the workspace/server name. You just need to copy the database name.
We recommend that the first login be carried out by an administrator account — the final step in the login process involves app permissions for your entire organization, and only administrators can adjust that setting.
If these app permissions aren’t accepted for the organization, non-admin users won’t be allowed to log in.
- Select the Azure Synapse data source in the destination you use with Supermetrics.
- Fill in your Tenant ID, Workspace name, and Database name.
- Log in to the Microsoft user account attached to the database.
- Accept the app permissions.
The Consent on behalf of your organization setting is optional. If it isn’t enabled, non-admin users won’t be able to use Supermetrics with Azure Synapse. - Close the login window when prompted.
You’re now ready to start pulling data from Azure Synapse with Supermetrics.
IP allowlisting
Your database must have the Supermetrics IPs allowlisted. Adjust this setting in the Firewalls and virtual which can be done in Firewalls and virtual networks section of database config.