Skip to content

Commit e58e782

Browse files
Merge pull request #35552 from dzsquared/drskwier/sqlpackage-170_2
170.2 draft
2 parents 705d748 + fcf5505 commit e58e782

2 files changed

Lines changed: 61 additions & 22 deletions

File tree

docs/tools/sqlpackage/release-notes-sqlpackage.md

Lines changed: 42 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ title: DacFx and SqlPackage Release Notes
33
description: Release notes for Microsoft SqlPackage.
44
author: dzsquared
55
ms.author: drskwier
6-
ms.reviewer: llali
7-
ms.date: 07/30/2025
6+
ms.reviewer: llali, randolphwest
7+
ms.date: 10/14/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: release-notes
@@ -19,6 +19,46 @@ ms.custom:
1919

2020
This article lists the features and fixes delivered by the released versions of SqlPackage.
2121

22+
## 170.2.70 SqlPackage
23+
24+
**Release date:** October 14, 2025
25+
26+
```bash
27+
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
28+
```
29+
30+
| Platform | Download |
31+
| --- | --- |
32+
| Windows .NET 8 | [.zip file](https://go.microsoft.com/fwlink/?linkid=2338326) |
33+
| Windows | [.msi file](https://go.microsoft.com/fwlink/?linkid=2338524) |
34+
| macOS .NET 8 | [.zip file](https://go.microsoft.com/fwlink/?linkid=2338443) |
35+
| Linux .NET 8 | [.zip file](https://go.microsoft.com/fwlink/?linkid=2338525) |
36+
37+
### Features
38+
39+
| Feature | Details |
40+
| --- | --- |
41+
| External models | Adds support for external models in Azure SQL Database and SQL Server 2025 for import, export, extract, deployment, and SQL project build. |
42+
| External models | Adds support for functions `AI_GENERATE_CHUNKS` and `AI_GENERATE_EMBEDDINGS`. |
43+
| JSON | Adds support for JSON indexes in Azure SQL Database and SQL Server 2025 for import, export, extract, deployment, and SQL project build. |
44+
| JSON | Adds support for JSON functions `JSON_ARRAYAGG`, `JSON_OBJECTAGG`, and `JSON_QUERY`. |
45+
| Platform | The SqlPackage .zip build .NET SDK is updated to 8.0.414 |
46+
| Regex | Adds support for the `REGEXP_LIKE` function. |
47+
| ScriptDom | Updated ScriptDom to version 170.128.0. |
48+
| Vector | Adds support for the vector indexes in Azure SQL Database and SQL Server 2025 for import, export, extract, deployment, and SQL project build. |
49+
| Vector | Expands support for vector data type to SQL Server 2025 and specifying the 32-bit float size. |
50+
| Vector | Adds support for Vector function `VECTOR_SEARCH`. |
51+
52+
### Fixes
53+
54+
| Feature | Details |
55+
| --- | --- |
56+
| Data masking | Fixed an issue where the datetime data masking functions weren't being recognized during project build. [GitHub issue](https://github.com/microsoft/DacFx/issues/476) |
57+
| External models | Fixed an issue where external model dependencies on a database-scoped credential would cause project build to fail. |
58+
| JSON | Fixed a bug when comparing JSON indexes with the default JSON path. |
59+
| Platform | References [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/5.1.7) v5.1.7. |
60+
| XML | Fixed an issue where the XML query path ([xQuery](../../xquery/xquery-language-reference-sql-server.md)) was not treated as case-sensitive during model comparison. Even on case-insensitive databases, the xQuery path is case-sensitive. [GitHub issue](https://github.com/microsoft/DacFx/issues/231) |
61+
2262
## 170.1.61 SqlPackage
2363

2464
**Release date:** July 30, 2025
@@ -88,7 +128,6 @@ dotnet tool install -g microsoft.sqlpackage --version 170.0.94
88128
| SQL projects | The default compatibility level for Azure SQL Database and SQL database in Fabric is now set to 170. For more information, see [Database compatibility level 170 in Azure SQL Database and SQL database in Microsoft Fabric](https://techcommunity.microsoft.com/blog/azuresqlblog/database-compatibility-level-170-in-azure-sql-database-and-sql-database-in-micro/4405102). |
89129
| Vector | Vector data type is now supported in the target platform `Azure SQL Database` for import, export, extract, deployment, and SQL project build. |
90130

91-
92131
### Fixes
93132

94133
|Feature|Details|
@@ -104,7 +143,6 @@ dotnet tool install -g microsoft.sqlpackage --version 170.0.94
104143
| SQL projects | Fixes an issue where build warnings are duplicated in output when code analysis is enabled. [GitHub](https://github.com/microsoft/DacFx/issues/481) |
105144
| SQL projects | Fixes an issue where [service broker](../../database-engine/configure-windows/sql-server-service-broker.md) parameters set to variables results in false warnings. [GitHub](https://github.com/microsoft/DacFx/issues/326) |
106145

107-
108146
## 162.5.57 SqlPackage
109147

110148
**Release date:** November 21, 2024

docs/tools/sqlpackage/sqlpackage-download.md

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: Download and Install SqlPackage
3-
description: "Download and Install SqlPackage for Windows, macOS, or Linux"
3+
description: Download and Install SqlPackage for Windows, macOS, or Linux
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan
7-
ms.date: 07/30/2025
7+
ms.date: 10/14/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: install-set-up-deploy
@@ -20,9 +20,9 @@ ms.custom:
2020

2121
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).
2222

23-
- **Version number:** 170.1.61
24-
- **Build number:** 170.1.61.1
25-
- **Release date:** July 30, 2025
23+
- **Version number:** 170.2.70
24+
- **Build number:** 170.2.70.1
25+
- **Release date:** October 14, 2025
2626

2727
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).
2828

@@ -75,7 +75,7 @@ If you encounter issues during installation, follow these steps:
7575

7676
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).
7777

78-
2. **Verify NuGet source configuration**: SqlPackage is published to `nuget.org`, a public NuGet feed. You may encounter an error indicating that `microsoft.sqlpackage` can't be found:
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:
7979

8080
```output
8181
microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\
@@ -93,7 +93,7 @@ If you encounter issues during installation, follow these steps:
9393
dotnet nuget add source https://api.nuget.org/v3/index.json
9494
```
9595

96-
3. **Retry installation**: After verifying the .NET SDK installation and NuGet source configuration, retry installing SqlPackage using the appropriate command:
96+
1. **Retry installation**: After verifying the .NET SDK installation and NuGet source configuration, retry installing SqlPackage using the appropriate command:
9797

9898
```bash
9999
dotnet tool install -g microsoft.sqlpackage
@@ -120,11 +120,12 @@ A list of preview releases is available on the [dotnet tool feed for SqlPackage]
120120
SqlPackage is also prepared as a self-contained download for Windows, macOS, and Linux. No .NET install is required, however, the [operating system requirements](#supported-operating-systems) are the same as the [dotnet tool install](#installation-cross-platform). The dependencies included in this .zip download are updated more frequently in the [dotnet tool option for SqlPackage](#installation-cross-platform). The following links are for the latest version of SqlPackage:
121121

122122
| Platform | Download |
123-
| :--- | :--- |
124-
|Windows .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329922)|
125-
|Windows|[.msi file](https://go.microsoft.com/fwlink/?linkid=2329732)|
126-
|macOS .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329924)|
127-
|Linux .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329923)|
123+
| --- | --- |
124+
| Windows .NET 8 | [.zip file](https://go.microsoft.com/fwlink/?linkid=2338326) |
125+
| Windows| [.msi file](https://go.microsoft.com/fwlink/?linkid=2338524) |
126+
| macOS .NET 8 | [.zip file](https://go.microsoft.com/fwlink/?linkid=2338443) |
127+
| Linux .NET 8 | [.zip file](https://go.microsoft.com/fwlink/?linkid=2338525) |
128+
128129
### Linux
129130

130131
1. Download [SqlPackage for Linux](https://aka.ms/sqlpackage-linux)
@@ -264,22 +265,22 @@ SqlPackage runs on Windows, macOS, and Linux and is built using .NET 8. The [.NE
264265
This release of SqlPackage can be installed in the following languages:
265266

266267
SqlPackage .NET 8 Windows:
267-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2329922&clcid=0x40a)
268+
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2338326&clcid=0x40a)
268269

269270
SqlPackage .NET Framework Windows:
270-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2329732&clcid=0x40a)
271+
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2338524&clcid=0x40a)
271272

272273
SqlPackage .NET 8 macOS:
273-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2329924&clcid=0x40a)
274+
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2338443&clcid=0x40a)
274275

275276
SqlPackage .NET 8 Linux:
276-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2329923&clcid=0x40a)
277+
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2338525&clcid=0x40a)
277278

278279
## Related content
279280

280281
- [SqlPackage](sqlpackage.md)
281-
- [SqlPackage in CI/CD pipelines](sqlpackage-pipelines.md)
282+
- [SqlPackage in development pipelines](sqlpackage-pipelines.md)
282283
- [troubleshooting issues with SqlPackage](troubleshooting-issues-and-performance-with-sqlpackage.md)
283-
- [SQL projects](../sql-database-projects/sql-database-projects.md)
284+
- [What are SQL database projects?](../sql-database-projects/sql-database-projects.md)
284285
- [DacFx GitHub repository](https://github.com/microsoft/DacFx)
285286
- [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839)

0 commit comments

Comments
 (0)