Microsoft SQL Server

This procedure explains how to configure a Microsoft SQL Server/Microsoft SQL Server (jTds) database connection.

Before you begin: Make sure your database instance is configured to accept incoming connections from the following IP address:
63.33.83.29
If you are using Datalore On-Premises, its IP address is different. Contact your Datalore administrator for details.

Configure a Microsoft SQL Server connection

Open the New Microsoft SQL Server connection dialog.
1. Open the Attached data tool from the left-hand sidebar.
2. Switch to the Databases tab. You will see the list of all database connections available from the respective workspace.
3. Click New database.
4. In the New database connection dialog, select Microsoft SQL Server.
1. In the sidebar on the Home page, select the workspace where you want to create a Microsoft SQL Server connection.
2. In the workspace resources, select Data and switch to the Databases tab.
3. Click New database connection at the top right.
4. In the dialog, select Microsoft SQL Server.
On the General tab, select the connection type.
- default: to connect by specifying the Host, Port, and Database.
- URL only: to connect by providing the URL of a pre-built connection.
  Use this method to pass additional parameters. For example, add &SSL=true to the URL string to enable SSL.
Proceed based on the selected connection type:
1. In the Host field, type your server address.
2. In the Port field, type the port. The default port is 1433.
  Real port numbers might be different on your system. Verify that you use a correct port number with your database administrator, server settings, or hosting provider.
3. In the Instance field, type the instance you want to connect to.
4. Under Authentication, select an authentication method:
  - User & Password: to use your login and password
  - No auth: to connect without authentication required
  - Domain credentials: to connect using Windows domain authentication (for Microsoft SQL Server (jTds) only)
5. In the User and Password fields, specify your credentials if required by the selected authentication method.
6. (If Domain credentials is selected) In the Domain field, specify the domain.
7. In the Database field, type the database name to which you want to connect.
1. Under Authentication, select an authentication method:
  - User & Password: to use your login and password
  - No auth: to connect without authentication required
  - Domain credentials: to connect using Windows domain authentication (for Microsoft SQL Server (jTds) only)
2. In the User and Password fields, specify your credentials if required by the selected authentication method.
3. (If Domain credentials is selected) In the Domain field, specify the domain.
4. In the URL field, provide the URL of the pre-built connection you want to establish.
5. (If Domain credentials is selected) In the Domain field, specify the domain.
(Optional) For other options (SSH tunneling, scope inspection, or additional connection parameters), switch to the respective tab of the dialog and follow one of these procedures.
Click the Test connection button at the bottom of the dialog.
Once the connection is successfully tested, click the Create and close button.

Attach the connection to a notebook

If the notebook is not running, start it by clicking Run | Start machine.
In the sidebar, select Attached data and switch to the Databases tab.
Enable the toggle in your Microsoft SQL Server connection.

Open the notebook you want to attach the connection to.
If the notebook is not running, start it by clicking Run | Start machine.
In the sidebar, select Attached data and switch to the Databases tab.
Enable the toggle in your Microsoft SQL Server connection.

Next steps

To retrieve and process data from the connected database, use Query data with SQL cells.
Learn how to manage and delete database connections in a workspace and in a notebook.

17 November 2025