Microsoft SQL Server connection

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 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.

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

In a project
Click Assets > New asset > Prepare data > 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

Federal Information Processing Standards (FIPS) compliance

This connection is FIPS-compliant and can be used on a FIPS-enabled cluster.

Microsoft SQL Server setup

Microsoft SQL Server installation

Restriction

Except for NTLM authentication, Windows Authentication is not supported. For other forms of Windows authentication to Microsoft SQL Server, you can create a Generic JDBC connection with the latest Microsoft JDBC Driver for SQL Server. For an example JDBC URL, see Generic JDBC connection. Alternatively a Cloud Pak for Data administrator can create a Custom JDBC connector.

Running SQL statements

To ensure that your SQL statements run correctly, refer to the Transact-SQL Reference for the correct syntax.

Learn more

Microsoft SQL Server documentation

Parent topic: Supported connections