Deploy database using DACPAC and DAC Publish Profile
The Deploy Database task allows you to deploy a SQL Server Database to a SQL Server instance using a DACPAC and a DAC Publish Profile.
SQL Server Data Tools (SSDT) is Microsoft's design tool to declare the entire database model including tables, views, stored procedures, functions, schemas, etc. etc. covering all aspects of the database design. When you perform a build of a SSDT Visual Studio project, it creates a DACPAC which defines all of the SQL Server objects associated with a database. Once you have a DACPAC, it can be deployed using the Publish function in Visual Studio, or by using the SqlPackage.exe command-line interface.
The Deploy Database task simplifies the use of SqlPackage.exe to deploy a database from a DACPAC using a DAC Publish Profile. The great thing about DAC Publish Profiles is that they give you fine-grained control over how your database is upgraded. Essentially, during a database upgrade, SqlPackage.exe compares the content of the DACPAC with the existing database and generates a custom SQLCMD script which alters (upgrades) only those objects that are affected. You can tailor how SqlPackage.exe operates through the settings in the DAC Publish Profile. Typically, you will have several DAC Publish Profile within your Visual Studio solution; one for the CI pipeline, one for deployment during development and another for production upgrades. This is all explained in our guide to the DAC Publish Profile here.
To create a DAC Publish Profile you simply Publish from within Visual Studio. Clicking the Save Profile button in the Publish screen saves your DAC Publish Profile into your Visual Studio project for later re-use.
The Publish-DacPac task can be run on an in-house hosted Azure DevOps agent once SqlPackage.exe is installed. This can be done by installing either of the following:
Note that the latest SQLPackage.exe provides support for all previous versions of SQL Server.
The Deploy Database task can be used to automate the deployment of databases, either as part of a build in an Azure Pipeline, or as part of a server deployment using Azure DevOps Release Manager. To deploy databases using Octopus Deploy or other deployment service, you can utilise the PowerShell module PublishDacPac which underpins the Publish DACPAC task. PublishDacPac is available on the PowerShell Gallery here.
The following screenshot shows all the input parameters for the Deploy Database task which are explained in detail at the bottom of the page.
To automate build and deployment of databases in Azure DevOps, you can use the MsBuild task to create DACPAC from your Visual Studio solution. You can then add the Deploy Database task to deploy the DACPAC using your own custom DAC Publish Profile.
Below we show an example pipeline in Azure DevOps. First MsBuild builds the project. Second, the Deploy Database task deploys the database to your server. Typically, as part of a build, this will be an SQL Server instance on the actual build server machine.
Configure the settings for the Deploy Database task by entering the location that the previous build step will place the DACPAC.
Save and queue your build. A few minutes later, you should see a screen like this in Azure DevOps.
Below is the output of the Publish DACPAC task for a very simple database.
The following screenshot shows all the input parameters for the Deploy Database task which are explained in detail below.
Relative path to the database DACPAC that needs to be deployed. Wildcards can be used. Note that the repo root is held in the variable $(System.DefaultWorkingDirectory).
DAC Publish Profile Path
Relative path to the DAC Publish Profile. Wildcards can be used. Note that the repo root is held in the variable $(System.DefaultWorkingDirectory)
Target Server Name or IP address
Name of the target server, including instance and port if required. Setting this overwrites the server defined in the DAC Publish Profile
Target Database Name
Optional. Normally, the database will be named the same as your DACPAC. However, by completing this parameter, you can name the database anything you like. Setting this overwrites the database name defined in the DAC Publish Profile.
Overwrite SQLCMD Variables Options
Choose if you wish to overwrite SQLCMD Variables within the DAC Publish Profile. If so, select the format in which you will provide the values. We recommend JSON format as this is easy to validate in Visual Studio Code.
SqlCmd Variables and Values
Optional. A multi-line string containing SqlCmd Variables to be updated within the DAC Publish Profile. Using the previous selector, you can choose to provide these in either JSON format or as name/value pairs as depicted below.
Defines the preferred version of SqlPackage.exe to use. Simply pick 'latest' to use the latest version which can be used to deploy to all previous version of SQL Server. Note that if the preferred version cannot be found, the latest version will be used instead.