Skip to main content
net8.0

SqlPackage is a command-line utility that automates database development tasks by exposing some of the public Data-Tier Application Framework (DacFx) APIs.

Published
Feb 14, 2025
1y ago
Total Downloads
6.6M
6,564,056

Install

dotnet add package Microsoft.SqlPackage --version 170.0.57-preview
ProductVersions
.NET
net8.0

README

Microsoft SQL Server Data-Tier Application Framework (DacFx) Nuget Package

Overview

The Microsoft SQL Server Data-Tier Application Framework (DacFx) is a component which provides application lifecycle services for database development and management for Microsoft SQL Server and Microsoft Azure SQL Databases. DacFx supports various database deployment and management scenarios for SQL Server and Microsoft Azure SQL Databases including extracting / exporting a live database to a DAC package, deploying a DAC package to a new or existing database, and migrating from on-premises to Microsoft Azure.
This functionality is exposed via the DacFx API. DacFx can target SQL Server 2008 and newer, as well as Microsoft Azure SQL.

  This nuget package is a lightweight version of DacFx. If you would like to use the command-line utility SqlPackage.exe for creating and deploying .dacpac and .bacpac packages, please download SqlPackage.exe for Windows, macOS, or Linux from http://aka.ms/sqlpackage.

Dependencies

The package Microsoft.SqlServer.DacFx depends on the new ADO.Net Sql client driver in the Microsoft.Data.SqlClient nuget package.

Support

Open issues at DacFx github

Important Notice: Breaking Changes Due to Public Key Update

We would like to inform you about an important change in DacFx NuGet that may impact your applications. We have updated the public key in the DLLs included in this package. This change is crucial for enhancing the security and integrity of our assembly but may cause breaking changes in your C# applications.

Impact of Public Key Change

  • Build Failures: Applications referencing the old DLL with the previous public key will fail to build.
  • Runtime Errors: Applications may experience runtime errors if the old DLL is loaded dynamically or through reflection.
  • Configuration Updates: Any configuration files or settings that reference the old public key will need to be updated to the new key.

Steps to Address the Change

To mitigate the impact of this change, we recommend the following steps:

  • Update Package References: Ensure that you update your NuGet package reference to the latest version that includes the DLL with the new public key.
  • Rebuild Your Application: Rebuild your application to ensure it correctly references the new DLL.
  • Thorough Testing: Conduct comprehensive testing to identify and resolve any issues resulting from the public key change.
  • Update Documentation: Ensure that all relevant documentation and configuration files are updated to reflect the new public key.

Support and Assistance

We are committed to providing you with the necessary support during this transition. If you encounter any issues or need further assistance, please do not hesitate to contact our team at DacFx github

Changes from Previous Version

No structural changes between v170.0.48-preview and v170.0.57-preview.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

This version is marked prerelease. Validate its API and upgrade path before production use.No SPDX license expression is published. Review the license text and your organisation's policy before redistribution.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.