Setting database connection

To start with, you need to create a server connection.

To create a connection

1. On the Database menu, click New Connection. The Database Connection Properties dialog opens.

Setting database connection

2. In the Server field, open the list of servers and select either a local or network server from the list.


To connect to a SQL Server using a custom port, specify the server name followed by a comma and the custom port number. For example, localhost,62005.

3. Select the authentication type:

  • Windows Authentication
  • SQL Server Authentication
  • Active Directory - Universal with MFA authentication
  • Azure Active Directory - Password
  • Azure Active Directory - Integrated

For more information about how to connect to a database with the Azure Active Directory authentication, see Using Azure Interactive Authentication.

4. In the Login and Password fields, enter the login credentials. By default, the password is saved automatically. If you don’t want to save the password, clear the Allow saving password check box.

5. In the Database field, type a database you want to connect to or select the database from the dropdown list.

6. In the Connection Name box, the connection name are automatically generated from the host name. If you want to create a distinctive name for the connection, type the new name.

7. Optional: Assign an environment category (Development, Production, Sandbox, and Test) to the new connection.

8. Optional: Switch to the Advanced tab to configure advanced connection properties.

  • Connection timeout: Set the amount of time (in seconds) during which the server should wait to establish a connection. The default value is 15 seconds.
  • Execute timeout: Set the amount of time (in seconds) during which the task should be completed. The default value is 0 seconds.
  • Encrypt connection: Select the check box if you want to use the encrypted connection.
  • Enter additional connection string parameters: Set additional connection properties to the connection string.

Advanced connection tab

9. Optional: Click Test Connection to verify the connection.

10. Click Connect to create the connection.


If you set up a connection in one of the following tools, it will be automatically added to other dbForge SQL Tools:

You can migrate connections and assigned categories between dbForge SQL tools (for example, from dbForge Data Compare for SQL Server to dbForge Data Generator for SQL Server). To do that, you should create an export settings file with the help of Import and Export Settings Wizard in one tool and then import it in another dbForge SQL tool. For more information, see Import and export settings.

Windows connection coloring

Window connection coloring allows you immediately to know which server you’re connected to. You can add coloring for each server connection in the Environment Category field of the Database Connection Properties dialog box when setting the database connection properties. To do this, click an arrow in Environment Category and the select the coloring from the list.

Alternatively, click to open the Options wizard where you can select the coloring, edit, add, or delete the category.

Windows connection coloring

Edit a database connection

To edit a database connection, on the Database menu, click Connection Manager. The Connection Manager dialog box opens. Select the connection you want to update and then click Edit. The Database Connection Properties dialog box opens where you can make changes on database connection parameters.

Delete a database connection

To delete a database connection, on the Database menu, open the Connection Manager. Then, choose a connection you want to delete and click Delete.