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 that is 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
- SSL certificate (if required by the database server)
Credentials
Choose an authentication method:
Username and password
Username and Password to access the database in Microsoft Azure SQL Database.
Microsoft Entra ID is a cloud-based identity and access management service. To obtain connection values for the Entra ID authentication method, sign in to the Microsoft Azure portal. For information about Entra ID, refer to the following Microsoft documentation:
Entra ID client secret credential
- Client ID: The client ID for authorizing access to Microsoft Azure. To find the Client ID for your application, select Microsoft Entra ID. From App registrations, select your application. Click Copy to copy the Client ID of your application. For more information, see Register a Microsoft Entra app and create a service principal.
- Client secret: The authentication key that is associated with the client ID for authorizing access to Microsoft Azure. To find the Client secret for your application, select Microsoft Entra ID. From App registrations, select your application. Go to Certificates & secrets > Client secrets. Click Copy to copy the existing Client secret or click New client secret to create a new Client secret and copy it. For more information, see Register a Microsoft Entra app and create a service principal.
Entra ID username password credential
Username and Password for the Microsoft Azure account.
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.
If you connect with IBM Cloud Satellite, you need to set the Proxy connection policy on the Azure server in order to connect to the Azure SQL Database. For more information, see Azure SQL Database connectivity architecture.
Choose the method for creating a connection based on where you are in the platform
- In a project
- Click Assets > New asset > Connect to a data source. 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 Import assets > Data access > Connection. See Adding data assets 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
- Data quality rules (IBM Knowledge Catalog)
- DataStage (DataStage service). See Connecting to a data source in DataStage.
- Decision Optimization (watsonx.ai Studio and watsonx.ai Runtime)
- Metadata enrichment (IBM Knowledge Catalog)
- Metadata import (IBM Knowledge Catalog)
- SPSS Modeler (watsonx.ai Studio)
Catalogs
-
Platform assets catalog
-
Other catalogs (IBM Knowledge Catalog)
Data lineage
- Metadata import (lineage) (IBM Knowledge Catalog and IBM Manta Data Lineage)
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
Learn more
Parent topic: Supported connections