0 / 0
Microsoft Azure SQL Database connection

Microsoft Azure SQL Database connection

To access your data in a Microsoft Azure SQL Database, create a connection asset for it.

Microsoft Azure SQL Database is a managed cloud database provided as part of Microsoft Azure.

Create a connection to Microsoft Azure SQL Database

To create the connection asset, you need these connection details:

  • Database name
  • Hostname or IP address
  • Port number
  • Select Use Active Directory if the server has been set up to use Azure Active Directory authentication (Azure AD). Enter your Azure AD user and password.
  • Username and password
  • SSL certificate (if required by the database server)

For Private connectivity, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a secure connection.

Choose the method for creating a connection based on where you are in the platform

In a project
Click Assets > New asset > Data access tools > Connection. See Adding a connection to a project.
In a catalog
Click Add to catalog > Connection. See Adding a connection asset to a catalog.
In a deployment space
Click Add to space > Connection. See Adding connections to a deployment space.
In the Platform assets catalog
Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

Where you can use this connection

You can use Microsoft Azure SQL Database connections in the following workspaces and tools:


  • DataStage (DataStage service). See Connecting to a data source in DataStage.
  • Decision Optimization (Watson Studio and Watson Machine Learning)
  • Metadata enrichment (IBM Knowledge Catalog)
  • Metadata import (IBM Knowledge Catalog)
  • SPSS Modeler (Watson Studio)


  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

Running SQL statements

To ensure that your SQL statements run correctly, refer to the Azure SQL Database documentation for the correct syntax.

Microsoft Azure SQL Database setup

Getting started with single databases in Azure SQL Database

Learn more

Azure SQL Database documentation

Parent topic: Supported connections

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more