Contents

Link a database to Git

dbForge Source Control is a Microsoft SQL Server Management Studio (SSMS) add-in that is designed to manage database changes in the best-known version control systems. With the help of the tool, you can version-control database schemas and data, roll back unwanted changes, handle static data conflicts, and maintain the integrity of the database. Via Source Control, you can link your database to Git, a distributed version control system. Git is aimed at coordinating the work of multiple developers and provides non-linear workflow.

When dbForge Source Control connects to a Git repository, is the connection secure? In other words, is TLS enabled?

dbForge Source Control connects to Git using the standard Git client for Windows, which supports current security protocols, including TLS 1.2. Secure connections are established when the server both supports them and requires them. For instance, if a repository’s address begins with HTTPS and the server stipulates TLS, the connection will comply with these security requirements. The choice of security protocol is determined by the server’s configuration, not by dbForge settings.

Note

dbForge Source Control v2.2 and later support Git for Windows client version 2.28.0 and higher. You can check the Git version with the git --version command. Thanks to it you can work with all possible connection and authentication types, as this task is delegated to the Git client. Before trying to connect your database to Git, make sure that you have Git for Windows client installed on your machine.

See the following how-to topics to learn how to clone a remote repository and link a database to a Git repository in:

• GitHub
• Azure DevOps
• BitBucket
• GitLab

Working with a local Git repository

dbForge Source Control doesn’t work with either local or remote repositories directly – only through a clone. Therefore, you will need to create a local Git repository and then clone it.

For this, perform the following steps:

1. Create two empty folders on the disk of your computer where the local repository will be stored.

2. Start Windows Command Prompt (CMD).

Note

To navigate to the folder where the main local repository will be located, in the Command Prompt, use the cd command.

3. Type git init --bare to create the main repository locally.

4. Navigate to the second folder and clone the local repository you have just created using git clone <pathToMainRepo>. Make sure to place a dot at the end of the command to clone the repository to the folder you have created. Otherwise, another subfolder will be created.

Note

<pathToMainRepo> is the path to the main repository you created locally when executing the git init --bare command.

5. Execute these CMD commands in the folder in question:

• git commit --allow-empty -m initial to make an initial commit
• git push to push the changes to the remote repository

6. Link dbForge Source Control to that folder in the following order:

• In Object Explorer, right-click the database you want to link to source control and select Source Control > Link Database to Source Control.

• In the Link Database to Source Control dialog that opens, click + in the Source control repository field to open the Source Control Repository Properties dialog.

• In the dialog that opens, do the following:

  • Select Git from the Source Control system dropdown list.
  • In the Repository folder field, click More to select the repository folder.
  • Optional: In the Repository name field, you can change the name of the repository folder.

• Click Test to verify that the database has successfully been connected to source control.

• Click OK to close the Source Control Repository Properties dialog.

• In the Link Database to Source Control dialog, select a database development model and click Link.

Additionally, to get more information on how to create a local Git repository and link your database to it with the help of Source Control, watch this video.

In this video, we will explain how to collaborate on the same database project using dbForge Source Control for SQL Server. The video provides the case where two developers try to push database changes to a Git remote repository simultaneously.

To learn more about versioning SQL databases linked to Git, you can refer to the following pages:

• Step-by-Step Guide: How to Set Up Source Control for GitLab
• Create a New Git Repository and Set up SQL Source Control for Bitbucket
• How to Automatically Commit SQL Server Database Schema Changes to the GIT Repository

Want to Find out More?

• Previous
• Next