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 Credentials and Certificates, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

Connect to a Microsoft Azure SQL Database that is behind a firewall

To connect to a Microsoft Azure SQL Database that is behind a firewall, you must add the IP addresses of the cluster worker nodes to the firewall.

Find the IP addresses of the cluster worker nodes. Log in to Cloud Pak for Data and run this command:
oc get nodes -o wide
Note the IP addresses in the ROLE column that are identified as worker.
Use Windows Azure Management Portal or run sp_set_firewall_rule on the master database to create a firewall rule for the IP addresses of the cluster worker nodes.

For more information, see Azure SQL Database and Azure Synapse IP firewall rules.

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:

Projects

Cognos Dashboards (Cognos Dashboards service)
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 (SPSS Modeler service)
Synthetic Data Generator (Synthetic Data Generator service)

Catalogs

Platform assets catalog
Other catalogs (IBM Knowledge Catalog)

Watson Query service: You can connect to this data source from Watson Query.

Federal Information Processing Standards (FIPS) compliance

4.8.0 and 4.8.1: This connection is compliant with FIPS if you installed Cloud Pak for Data on or prior to January, 22, 2024.
4.8.2 and later: This connection is not compliant with FIPS, but it is FIPS-tolerant.

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