You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| Linux .NET 10 |[.zip file](https://go.microsoft.com/fwlink/?linkid=)|
36
+
37
+
### Features
38
+
39
+
| Feature | Details |
40
+
| --- | --- |
41
+
| Deployment | Adds support for database options `ACCELERATED_DATABASE_RECOVERY` and `OPTIMIZED_LOCKING`. |
42
+
| Permissions | Enhances permission publishing to include `EXECUTE ON EXTERNAL MODEL` permissions. |
43
+
| Platform | Adds .NET 10 support to the DacFx library and the SqlPackage CLI. The SqlPackage `dotnet tool` is available for both .NET 8 and .NET 10. |
44
+
| Platform | Adds .NET Standard 2.0 support to the DacFx library. |
| ScriptDom | Updated ScriptDom to version 170.157.0. |
47
+
| Vector | Extends vector column support to allow changing the base type. |
48
+
49
+
### Fixes
50
+
51
+
| Feature | Details |
52
+
| --- | --- |
53
+
| SQL projects | Fixed an issue where building a SQL project with an inline clustered columnstore index definition on a table would fail with a syntax error. [GitHub issue](https://github.com/microsoft/DacFx/issues/719)|
54
+
| SQL projects | Fixed an issue where a clustered columnstore index on a table with `NVARCHAR(MAX)` or other LOB-type columns would incorrectly report an error that columnstore indexes aren't supported with vector columns. [GitHub issue](https://github.com/microsoft/DacFx/issues/713)|
55
+
| Deployment | Fixed a bug with deploying to SQL database in Microsoft Fabric when the target database includes a security policy. |
56
+
| Export | Fixed an issue where exported `.dacpac` files would fail XSD schema validation due to boolean attribute values using `True`/`False` instead of lowercase `true`/`false`. [GitHub issue](https://github.com/microsoft/DacFx/issues/604)|
57
+
| Import | Fixed an issue where importing a table with special characters in the name (such as `/`, `"`, or `$`) would silently fail to import data without warning the user. [GitHub issue](https://github.com/microsoft/DacFx/issues/637)|
58
+
| Ledger | Fixed an issue where a ledger table with a computed column would cause a `NullReferenceException` during model validation and build. [GitHub issue](https://github.com/microsoft/DacFx/issues/735)|
59
+
| Vector | Fixed an issue where procedures using `VECTOR_SEARCH` would report a validation warning that the column reference could not be resolved. [GitHub issue](https://github.com/microsoft/DacFx/issues/706)|
Copy file name to clipboardExpand all lines: docs/tools/sqlpackage/sqlpackage-download.md
+28-24Lines changed: 28 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Download and Install SqlPackage for Windows, macOS, or Linux
4
4
author: dzsquared
5
5
ms.author: drskwier
6
6
ms.reviewer: maghan
7
-
ms.date: 10/14/2025
7
+
ms.date: 2/10/2026
8
8
ms.service: sql
9
9
ms.subservice: tools-other
10
10
ms.topic: install-set-up-deploy
@@ -20,18 +20,18 @@ ms.custom:
20
20
21
21
SqlPackage runs on Windows, macOS, and Linux, and is available to install through `dotnet tool` or as a standalone zip download. For details about the latest release, see the [release notes](release-notes-sqlpackage.md).
22
22
23
-
-**Version number:** 170.2.70
24
-
-**Build number:** 170.2.70.1
25
-
-**Release date:**October 14, 2025
23
+
-**Version number:** 170.3.xx
24
+
-**Build number:** 170.3.xx.x
25
+
-**Release date:**February 10, 2026
26
26
27
-
SqlPackage is developed and released for both .NET 8 and .NET Framework. Installing the .NET 8 SqlPackage version is recommended via the [convenient `dotnet tool` method](#installation-cross-platform), which is cross-platform and easy to update, or via the [portable self-contained .zip download](#installation-file-download-alternative). The .NET 8 SqlPackage releases benefit from the continual advances to the performance and scalability of .NET as part of the [focus on for modern applications](/dotnet/core/introduction#net-ecosystem), which contrasts to the maintenance support of .NET Framework for Windows. The .NET Framework version is only available as a [.msi Windows installer](#windows-net-framework).
27
+
SqlPackage is developed and released for both .NET and .NET Framework. Installing the .NET 10 SqlPackage version is recommended via the [convenient `dotnet tool` method](#installation-cross-platform), which is cross-platform and easy to update, or via the [portable self-contained .zip download](#installation-file-download-alternative). The .NET 10 SqlPackage releases benefit from the continual advances to the performance and scalability of .NET as part of the [focus on for modern applications](/dotnet/core/introduction#net-ecosystem), which contrasts to the maintenance support of .NET Framework for Windows. The .NET Framework version is only available as a [.msi Windows installer](#windows-net-framework).
28
28
29
29
> [!NOTE]
30
30
> Previously, SqlPackage had a distinct version number (19) and build number (160.x). Beginning with version 161, the version number of SqlPackage matches the DacFx version number it's associated with (for example, 162.0.52).
31
31
32
32
## Installation, cross-platform
33
33
34
-
Installing SqlPackage as a [dotnet tool](/dotnet/core/tools/global-tools) requires the [.NET SDK](https://dotnet.microsoft.com/download/dotnet/8.0) to be installed on your machine. Installing SqlPackage as a global tool makes it available on your path as `sqlpackage` and is the recommended method to install SqlPackage for Windows, macOS, and Linux. SqlPackage is available as a dotnet tool for .NET 8 and later versions.
34
+
Installing SqlPackage as a [dotnet tool](/dotnet/core/tools/global-tools) requires the [.NET SDK](https://dotnet.microsoft.com/download/dotnet/10.0) to be installed on your machine. Installing SqlPackage as a global tool makes it available on your path as `sqlpackage` and is the recommended method to install SqlPackage for Windows, macOS, and Linux. SqlPackage is available as a dotnet tool for .NET 8 and later versions.
35
35
36
36
To install SqlPackage as a global .NET tool, run the following command:
37
37
@@ -53,15 +53,15 @@ To uninstall SqlPackage, run the following command:
53
53
dotnet tool uninstall -g microsoft.sqlpackage
54
54
```
55
55
56
-
### Install SqlPackage with .NET 9 or later
56
+
### Install SqlPackage with future releases of .NET
57
57
58
58
To install SqlPackage with a newer version of the .NET SDK, add `--allow-roll-forward` to the install command:
This option allows SqlPackage to use a newer version of the .NET runtime if .NET 8 isn't installed.
64
+
This option allows SqlPackage to use a newer version of the .NET runtime if .NET 8 or .NET 10 isn't installed.
65
65
66
66
### Troubleshoot installation
67
67
@@ -73,7 +73,7 @@ If you encounter issues during installation, follow these steps:
73
73
dotnet --list-sdks
74
74
```
75
75
76
-
If the .NET SDK isn't listed, download and install it from the [.NET SDK download page](https://dotnet.microsoft.com/download/dotnet/8.0).
76
+
If the .NET SDK isn't listed, download and install it from the [.NET SDK download page](https://dotnet.microsoft.com/download/dotnet/10.0).
77
77
78
78
1.**Verify NuGet source configuration**: SqlPackage is published to `nuget.org`, a public NuGet feed. You might encounter an error indicating that `microsoft.sqlpackage` can't be found:
79
79
@@ -121,10 +121,10 @@ SqlPackage is also prepared as a self-contained download for Windows, macOS, and
121
121
122
122
| Platform | Download |
123
123
| --- | --- |
124
-
| Windows .NET 8|[.zip file](https://go.microsoft.com/fwlink/?linkid=2338326)|
124
+
| Windows .NET 10|[.zip file](https://go.microsoft.com/fwlink/?linkid=2338326)|
| Linux .NET 10|[.zip file](https://go.microsoft.com/fwlink/?linkid=2338525)|
128
128
129
129
### Linux
130
130
@@ -192,7 +192,7 @@ SqlPackage is also prepared as a self-contained download for Windows, macOS, and
192
192
sudo spctl --master-enable
193
193
```
194
194
195
-
### Windows (.NET 8)
195
+
### Windows (.NET 10)
196
196
197
197
1. Download [SqlPackage for Windows](https://aka.ms/sqlpackage-windows)
198
198
1. Extract the file by right-clicking on the file in Windows Explorer, and selecting 'Extract All...', and select the target directory
@@ -218,6 +218,13 @@ If you installed SqlPackage with a .zip or other archive, then delete the files.
218
218
219
219
### Automated environments
220
220
221
+
Installing the dotnet tool version of SqlPackage is recommended for automated environments, such as CI/CD pipelines, due to its ease of installation and update. However, the file download option can be used in automated environments as well.
222
+
223
+
```bash
224
+
dotnet tool install -g microsoft.sqlpackage
225
+
```
226
+
227
+
221
228
Evergreen links are available for downloading the latest SqlPackage versions:
222
229
223
230
- Linux (<https://aka.ms/sqlpackage-linux>)
@@ -235,12 +242,9 @@ Adding the NuGet package to a .NET project is accomplished via the .NET CLI with
235
242
dotnet add package Microsoft.SqlServer.DacFx
236
243
```
237
244
238
-
> [!NOTE]
239
-
> Other NuGet packages were published under the DacFx name, `Microsoft.SqlServer.DacFx.x64` and `Microsoft.SqlServer.DacFx.x86`. Support for both platforms is covered under the `Microsoft.SqlServer.DacFx` package. New references should be made to this package, not the x64 or x86 variants.
240
-
241
245
## Supported Operating Systems
242
246
243
-
SqlPackage runs on Windows, macOS, and Linux and is built using .NET 8. The [.NET 8 OS requirements](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md) are minimum requirements for SqlPackage, which has extra requirements due to its dependencies.
247
+
SqlPackage runs on Windows, macOS, and Linux and is built using .NET 10. The [.NET 10 OS requirements](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md) are minimum requirements for SqlPackage, which has extra requirements due to its dependencies.
244
248
245
249
### Windows (x64)
246
250
@@ -251,29 +255,29 @@ SqlPackage runs on Windows, macOS, and Linux and is built using .NET 8. The [.NE
251
255
252
256
### macOS
253
257
254
-
- macOS 12 "Monterey"+
258
+
- macOS 14 "Sonoma"+
255
259
256
260
### Linux (x64)
257
261
258
-
- Debian 11+
262
+
- Debian 12+
259
263
- Red Hat Enterprise Linux 8+
260
-
- SUSE Linux Enterprise Server v12 SP2+
261
-
- Ubuntu 20.04+
264
+
- SUSE Linux Enterprise Server 15 SP6+
265
+
- Ubuntu 22.04+
262
266
263
267
## Available Languages
264
268
265
269
This release of SqlPackage can be installed in the following languages:
0 commit comments