About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
Microsoft SQL Server connection
Last updated: May 30, 2025
Create a connection asset for Microsoft SQL Server.
Microsoft SQL Server is a relational database management system.
Supported versions
- Microsoft SQL Server 2022.
Create a connection to Microsoft SQL Server
To create the connection asset, specify these connection details:
-
Database name You don't have to specify the database. With no database specified, you can import metadata from every database that is available for that connection.
-
Hostname or IP address
-
Port number or Instance name If the server is configured for dynamic ports, use the Instance name.
-
Username and password
-
Domain name If the Microsoft SQL Server has been set up in a domain that uses NTLM (New Technology LAN Manager) authentication, select Use Active Directory and enter the name of the domain that is associated with the 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 > 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
Microsoft SQL Server setup
Restriction
Except for NTLM authentication, Windows Authentication is not supported.
Running SQL statements
To ensure that your SQL statements run correctly, refer to the Transact-SQL Reference for the correct syntax.
Learn more
Parent topic: Supported connections
Was the topic helpful?
0/1000