{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","callout","img","partial","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"},"seo":{"title":"Integrate Microsoft Azure with Databox","description":"Connect Azure SQL Database to Databox to query your data, build datasets with SQL, and visualize results alongside your other tools.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-microsoft-azure-with-databox","__idx":0},"children":["Integrate Microsoft Azure with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"exclusive"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Azure SQL Database is a fully managed relational database service built on the SQL Server engine. It handles provisioning, patching, backups, and scaling automatically, and runs on the same engine as on-premises SQL Server instances while removing the need to manage underlying infrastructure. Connecting Azure SQL Database to Databox lets you pull data directly from your managed database, build datasets using SQL queries, and visualize business-critical figures alongside data from your other connected tools."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've already established a connection, you can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-data-source"},"children":["reuse"]}," it to add new data sources to your Databox account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-create-a-read-only-sql-server-login-for-databox","__idx":2},"children":["Step 1: Create a read-only SQL Server login for Databox"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox only reads data from your database — it never writes to it. Create a dedicated SQL Server login with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT"]},"-only permissions on the database you want to connect. You can run these commands using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query editor"]}," in the Azure portal, or via a SQL Server client (such as SSMS or Azure Data Studio) connected to your instance."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"CREATE LOGIN databox WITH PASSWORD = 'your_secure_password';\nGO\nUSE your_database;\nGO\nCREATE USER databox FOR LOGIN databox;\nGO\nGRANT SELECT ON SCHEMA::dbo TO databox;\nGO\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["your_database"]}," with the name of the database you want to connect, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["your_secure_password"]}," with a strong password. If you need to grant access to additional schemas, repeat the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GRANT SELECT ON SCHEMA"]}," statement for each one."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATE LOGIN"]}," statement must be run in the context of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["master"]}," database, while ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATE USER"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GRANT"]}," must be run against ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["your_database"]},". If using the Azure portal Query editor, switch between databases using the database selector at the top of the editor."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["Avoid the following special characters in your password, as they can cause encoding issues when establishing the connection: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["`"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\"]},", and spaces."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-enable-public-access-on-your-azure-sql-server","__idx":3},"children":["Step 2: Enable public access on your Azure SQL server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox connects to Azure SQL Database over a public endpoint. Verify that the public endpoint is enabled on your logical SQL server."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://portal.azure.com"},"children":["Azure portal"]},", go to your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SQL server"]}," resource (not the individual database)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Networking"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public access"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Selected networks"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to apply the change."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["The server's fully qualified hostname is shown on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]}," page of your SQL server resource (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["myserver.database.windows.net"]},"). Copy this value — you will need it in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-4-enter-your-azure-sql-connection-details-in-databox"},"children":["Step 4"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-add-the-databox-ip-to-your-firewall-rules","__idx":4},"children":["Step 3: Add the Databox IP to your firewall rules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Azure SQL Database uses server-level firewall rules to control inbound network access. Add a rule that permits connections from the Databox IP address."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://portal.azure.com"},"children":["Azure portal"]},", go to your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SQL server"]}," resource."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Networking"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firewall rules"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a firewall rule"]}," and enter:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rule name"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Databox"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start IPv4 address"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52.4.198.118"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["End IPv4 address"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52.4.198.118"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-enter-your-azure-sql-connection-details-in-databox","__idx":5},"children":["Step 4: Enter your Azure SQL connection details in Databox"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Databox, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Sources > + New connection"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Microsoft Azure"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fill in the connection form:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data source name"]}," — a label for this connection in Databox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Server Name"]}," — the fully qualified server name of your Azure SQL server, found on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]}," page in the Azure portal (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["myserver.database.windows.net"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username"]}," — the SQL Server login name created in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-1-create-a-read-only-sql-server-login-for-databox"},"children":["Step 1"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password"]}," — the password for that login."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Database name"]}," (optional) — the specific database to connect to. Leave blank to connect at the server level."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timezone"]}," — the time zone used to interpret date values in query results. Defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Etc/UTC"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-microsoft-azure-with-databox_1.3fa04ae4709c1f195d7b521b2b7f80fec950ea71639d5261d6aee1d47da25356.4783b0ec.png","alt":"connect","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"datasets","__idx":6},"children":["Datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Microsoft Azure integration supports the creation of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["datasets"]},", which allow you to define and shape the specific data you want to use for reporting in Databox. Datasets make it easier to focus on the most relevant information, enabling you to filter, visualize, and analyze metrics across projects, teams, and clients without writing complex queries each time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps-to-create-a-dataset","__idx":7},"children":["Steps to create a dataset"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select a table"]},": Pick the appropriate schema within that database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select columns"]},": Browse and select the specific columns (fields) from your tables or views to include in your dataset. These columns define the structure and content of your dataset."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-write-sql","__idx":8},"children":["Optional: Write SQL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more advanced use cases, you can write a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["custom SQL query"]}," instead of selecting columns manually. This allows you to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Join multiple tables"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply filters and aggregations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Format or transform data before importing it into Databox"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your query must return a valid tabular result to be used as a dataset."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":9},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://learn.microsoft.com/en-us/azure/azure-sql/database/"},"children":["Azure SQL Database documentation"]}," — Official Microsoft docs for Azure SQL Database, covering deployment, connectivity, security, backups, high availability, and monitoring."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://learn.microsoft.com/en-us/azure/azure-sql/database/network-access-controls-overview"},"children":["Azure SQL Database networking overview"]}," — Guidance on public endpoint access, firewall rules, private endpoints, and virtual network service endpoints."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":10},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"azuresql","hideMetrics":true},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Do I configure firewall rules on the SQL server resource or the database resource?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Firewall rules are set at the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SQL server"]}," (logical server) level, not on the individual database. A rule added to the logical server applies to all databases hosted on that server. In the Azure portal, navigate to the SQL server resource — not the SQL database — and open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security > Networking"]}," to manage firewall rules."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does Databox support Azure Active Directory (Entra ID) authentication?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. Databox connects to Azure SQL Database using SQL Server authentication (username and password only). Azure Active Directory (Microsoft Entra ID) authentication is not supported. Make sure the login you create in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-1-create-a-read-only-sql-server-login-for-databox"},"children":["Step 1"]}," uses SQL Server authentication, not Azure AD authentication."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"What should I do if Databox cannot connect to my Azure SQL instance?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the following in order:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public access"]}," is set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Selected networks"]}," on the SQL server (under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security > Networking"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["firewall rule"]}," exists with both start and end IP set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["52.4.198.118"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The SQL Server login was created in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["master"]}," database and a corresponding user with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT"]}," permissions exists in the target database."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate Microsoft Azure with Databox","id":"integrate-microsoft-azure-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Step 1: Create a read-only SQL Server login for Databox","id":"step-1-create-a-read-only-sql-server-login-for-databox","depth":3},{"value":"Step 2: Enable public access on your Azure SQL server","id":"step-2-enable-public-access-on-your-azure-sql-server","depth":3},{"value":"Step 3: Add the Databox IP to your firewall rules","id":"step-3-add-the-databox-ip-to-your-firewall-rules","depth":3},{"value":"Step 4: Enter your Azure SQL connection details in Databox","id":"step-4-enter-your-azure-sql-connection-details-in-databox","depth":3},{"value":"Datasets","id":"datasets","depth":2},{"value":"Steps to create a dataset","id":"steps-to-create-a-dataset","depth":3},{"value":"Optional: Write SQL","id":"optional-write-sql","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-microsoft-azure-with-databox","seo":{"title":"Integrate Microsoft Azure with Databox","description":"Connect Azure SQL Database to Databox to query your data, build datasets with SQL, and visualize results alongside your other tools."},"keywords":{"includes":["Azure SQL Server integration","connect Azure SQL Database to Databox","Azure SQL Server dataset","Azure SQL Server custom SQL query","Azure SQL Server read-only login","Azure SQL firewall rule Databox","whitelist Databox IP Azure SQL","Azure SQL public access","Azure SQL Server cannot connect","Azure SQL Server port 1433"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"Exclusive to select subscription plans"}},"lastModified":"2026-04-17T19:27:17.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-microsoft-azure-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}