Source Control using Azure Data Studio and GitHub
|You can maintain and deploy code easily|
Source control is a vital part of IT work, since it is used to track changes over sofware and documents, with two main benefits: having a centralized, up to date copy of all your applications and utilities, and to be able to rollback to a previous stable version in case of a failed deployment.
This is perfectly applicable to SQL Server, where you want to have an updated and ready to deploy elsewhere copy of your database objects.
There are a lot of source control applications and software, every one has its pros and cons, but personally I like to use Git Hub , since it is free to use and since it was recently adquired by Microsoft, support for other products is easier (SQL Server for this case).
On this post I will show you how to implement a source control for a database using GitHub and Azure Data Studio (ADS) .
Setting up your machine
First of all, you need to have Azure Data Studio installed and running on your machine, and also a GitHub account to be able to upload and maintain your files.
To verify Git is installed correctly, just open any command prompt and type git then press enter:
Configuring Azure Data Studio
To be able to use source control on ADS, we have to perform some simple steps:
Open ADS and click on File>Open Folder, locate the folder you want for work and click OK (can be an empty folder for now).
For this example I am using C:ReposSourceControlDB
You can see that now the selected folder appears on the top bar
Once a folder is selected, click on Source Control, located on the left bar
Click on Initialize Repository
And that is all, you are ready to work with source control.
Working with Git
Adding a file to source control
Now we will add an object to our Git folder to see how sourcing works.
Open any already created database object or a TSQL query on your ADS IDE
Save it on your Git Folder with a meaningful name
Once saved, you can see the filed is added to the source control as an untracked change
Just select the changes you want to commit (in case you have more open files) and then click on Commit on the upper right corner of the source control area
Since the changes have not been staged, a message box ask to do it automatically, click on Yes
Provide a meaningful commit message and press Enter
Now the file has been added to source control successfully.
Editing the file
We now proceed to do a simple change on the stored procedure
At the moment you save the file, you can notice that a new change is added to source control and modified or added lines are marked on the file
If you click on the change, you can now see the actual changes made to the file
If you are Ok with the changes, commit them using the same option as earlier, and that is the basic Git usage.
We will cover the rollback, merge and some other features on a next post.
Now we will learn how to upload your local Git files to GitHub.
Linking your repository to GitHub the first time
Linking your local repository to GitHub is the next step, and the easiest way is using your GitHub profile, so let’s do it…
Create a new repository on your profile with the options you want, and click on Create Repository
In the next step copy the code for pushing an extisting Git repository
Open a new command prompt, navigate to your Git folder and paste the code there, one line at a time
In my case for the first line, the origin already exists so it will throw an error, but for your first time it will execute ok, for the second line, after a few moments it will ask you for username and password
After a few moments (depending on your folder size) files will be uploaded and now your repository is uploaded to GitHub successfully (as long with all the versions you have)
You have successfully linked your Git folder with GitHub, as you can see the file is uploaded
Your GitHub is now linked
Since we have done the linking, you can upgrade existing or add new files and they will be uploaded to GitHub when you commit the changes and sync them.
We perform another quick change to our file and commit it
Then we click on Sync to synchronize with GitHub
After the process ends, if you check your GitHub repository you can see the new change
Now you have configured your environment to support source control directly to GitHub. On the next post we will see some other advanced options, like perform the sync automatically.
Also we will learn how to pull those files from another place and apply them to other SQL Server instance.
SQL Server Database Administrator/Developer with experience in large environments. I have worked on IT for nearly 15 years in different areas. Microsoft Certified Solutions Associate: SQL 2016 Database Administration since 2018. Microsoft Certified Solutions Associate: SQL Server 2012/2014 since 2017. Microsoft Certified Professional since 2014.
原文 : SQLServerCentral