Skip to content

Commit 2a12f7a

Browse files
committed
rel notes
1 parent c691baa commit 2a12f7a

File tree

6 files changed

+30
-26
lines changed

6 files changed

+30
-26
lines changed

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

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Release notes for Microsoft SqlPackage.
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: llali
7-
ms.date: 07/29/2025
7+
ms.date: 07/30/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: release-notes
@@ -21,29 +21,32 @@ This article lists the features and fixes delivered by the released versions of
2121

2222
## 170.1.61 SqlPackage
2323

24-
**Release date:** April 15, 2025
24+
**Release date:** July 30, 2025
2525

2626
```bash
2727
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
2828
```
2929

3030
|Platform|Download|
3131
|:---|:---|
32-
|Windows .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2316204)|
33-
|Windows|[.msi file](https://go.microsoft.com/fwlink/?linkid=2316310)|
34-
|macOS .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2316113)|
35-
|Linux .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2316311)|
32+
|Windows .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329922)|
33+
|Windows|[.msi file](https://go.microsoft.com/fwlink/?linkid=2329732)|
34+
|macOS .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329924)|
35+
|Linux .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329923)|
3636

3737
### Features
3838

3939
|Feature|Details|
4040
|:---|:---|
41-
| Deployment | Adds support for publish properties `/p:IgnorePreDeployScript` and `/p:IgnorePostDeployScript`. These properties default to `false` and when enabled result in the |
41+
| Data virtualization | Adds support for objects related to [data virtualization](/azure/azure-sql/database/data-virtualization-overview?view=azuresql&tabs=sas&preserve) for Azure SQL Database in import, export, extract, and publish operations. |
42+
| Data virtualization | Adds Azure SQL Database to the [publish with parquet files preview](sqlpackage-with-data-in-parquet-files.md), enabling the use of Azure Blob Storage and parquet files to import data to a database. Extracting data to parquet files is not available for Azure SQL Database as it depends on [functionality not available in Azure SQL Database](/azure/azure-sql/database/data-virtualization-overview?view=azuresql&tabs=sas&preserve#limitations), `CREATE EXTERNAL TABLE AS SELECT`. |
43+
| Deployment | Adds support for publish properties `/p:IgnorePreDeployScript` and `/p:IgnorePostDeployScript`. These properties default to `false` and when enabled result in the deployment plan omitting the corresponding scripts. [GitHub issue](https://github.com/microsoft/DacFx/issues/647) |
4244
| Permissions | Adds support for the permission `ALTER ANY EXTERNAL MIRROR` for Azure SQL Database and SQL database in Fabric. This permission is required to export a database that contains one or more [mirrored tables](/fabric/database/mirrored-database/azure-sql-database-limitations). [GitHub issue](https://github.com/microsoft/DacFx/issues/648) |
4345
| Permissions | Adds support for the permissions `CREATE ANY EXTERNAL MODEL` and `ALTER ANY EXTERNAL MODEL` for SQL Server 2025. |
4446
| Permissions | Adds support for the permission `ALTER ANY INFORMATION PROTECTION` for SQL Server 2025 and Azure SQL Database. |
45-
| ScriptDom | Updated ScriptDom to version 170.0.44. |
46-
47+
| Platform | The SqlPackage .zip build .NET SDK is updated to 8.0.412 |
48+
| ScriptDom | Updated ScriptDom to version 170.0.64. |
49+
| ScriptDom | Updates the Data warehouse in Fabric platform to leverage the `TSqlFabricDWParser` in ScriptDom. |
4750

4851
### Fixes
4952

@@ -56,7 +59,6 @@ dotnet tool install -g microsoft.sqlpackage --version 170.1.61
5659
| Deployment | Fixed an issue where clustered columnstore indexes were being created by first creating a clustered index, causing the deployment to incur additional overhead and time. [GitHub issue](https://github.com/microsoft/DacFx/issues/264) |
5760
| Extract | Fixed an issue where extracting a database from SQL database in Fabric would result in unusable user definition scripts. [GitHub issue](https://github.com/microsoft/DacFx/issues/631) |
5861

59-
6062
## 170.0.94 SqlPackage
6163

6264
**Release date:** April 15, 2025

docs/tools/sqlpackage/sqlpackage-deploy-drift-report.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to automate database development tasks with SqlPackage De
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan
7-
ms.date: 11/14/2021
7+
ms.date: 07/30/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: install-set-up-deploy

docs/tools/sqlpackage/sqlpackage-download.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ 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/29/2025
7+
ms.date: 07/30/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: install-set-up-deploy
@@ -22,7 +22,7 @@ SqlPackage runs on Windows, macOS, and Linux, and is available to install throug
2222

2323
- **Version number:** 170.1.61
2424
- **Build number:** 170.1.61.1
25-
- **Release date:** July 29, 2025
25+
- **Release date:** July 30, 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

@@ -111,10 +111,10 @@ SqlPackage is also prepared as a self-contained download for Windows, macOS, and
111111

112112
| Platform | Download |
113113
| :--- | :--- |
114-
|Windows .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2316204)|
115-
|Windows|[.msi file](https://go.microsoft.com/fwlink/?linkid=2316310)|
116-
|macOS .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2316113)|
117-
|Linux .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2316311)|
114+
|Windows .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329922)|
115+
|Windows|[.msi file](https://go.microsoft.com/fwlink/?linkid=2329732)|
116+
|macOS .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329924)|
117+
|Linux .NET 8 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2329923)|
118118
### Linux
119119

120120
1. Download [SqlPackage for Linux](https://aka.ms/sqlpackage-linux)
@@ -254,16 +254,16 @@ SqlPackage runs on Windows, macOS, and Linux and is built using .NET 8. The [.NE
254254
This release of SqlPackage can be installed in the following languages:
255255

256256
SqlPackage .NET 8 Windows:
257-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2316204&clcid=0x40a)
257+
[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)
258258

259259
SqlPackage .NET Framework Windows:
260-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2316310&clcid=0x40a)
260+
[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)
261261

262262
SqlPackage .NET 8 macOS:
263-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2316113&clcid=0x40a)
263+
[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)
264264

265265
SqlPackage .NET 8 Linux:
266-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2316311&clcid=0x40a)
266+
[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)
267267

268268
## Related content
269269

docs/tools/sqlpackage/sqlpackage-publish.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to automate database development tasks with SqlPackage Pu
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan
7-
ms.date: 9/29/2022
7+
ms.date: 07/30/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: conceptual

docs/tools/sqlpackage/sqlpackage-script.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to automate database development tasks with SqlPackage Sc
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: maghan
7-
ms.date: 12/19/2022
7+
ms.date: 07/30/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: conceptual

docs/tools/sqlpackage/sqlpackage-with-data-in-parquet-files.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Tips for using SqlPackage with data stored in Azure Blob Storage
44
author: dzsquared
55
ms.author: drskwier
66
ms.reviewer: llali, randolphwest
7-
ms.date: 04/17/2025
7+
ms.date: 07/30/2025
88
ms.service: sql
99
ms.subservice: tools-other
1010
ms.topic: conceptual
@@ -16,12 +16,14 @@ ms.custom:
1616

1717
# SqlPackage with data in Parquet files (preview)
1818

19-
This article covers SqlPackage support for interacting with data stored in Azure Blob Storage that is in Parquet format. For SQL Server 2022 and Azure SQL Managed Instance, preview support for [extract](#extract-export-data) and [publish](#publish-import-data) with data in Parquet files in Azure Blob Storage is available in SqlPackage 162.1.176 and higher. Azure SQL Database and SQL Server 2019 and earlier aren't supported. The [import](sqlpackage-import.md) and [export](sqlpackage-export.md) actions continue to be available for SQL Server, Azure SQL Managed Instance, and Azure SQL Database. Support for Parquet files in Azure Blob Storage continues to be generally available for [Azure Synapse Analytics](sqlpackage-for-azure-synapse-analytics.md).
19+
This article covers SqlPackage support for interacting with data stored in Azure Blob Storage that is in Parquet format.
2020

2121
With [extract](#extract-export-data), the database schema (`.dacpac` file) is written to the local client running SqlPackage and the data is written to Azure Blob Storage in Parquet format. The data is stored in individual folders named with two-part table names. [CREATE EXTERNAL TABLE AS SELECT (CETAS)](../../t-sql/statements/create-external-table-as-select-transact-sql.md) is used to write the files in Azure Blob Storage.
2222

2323
With [publish](#publish-import-data), the database schema (`.dacpac` file) is read from the local client running SqlPackage and the data is read from or written to Azure Blob Storage in Parquet format.
2424

25+
For SQL Server 2022 and Azure SQL Managed Instance, preview support for [extract](#extract-export-data) and [publish](#publish-import-data) with data in Parquet files in Azure Blob Storage is available in SqlPackage 162.1.176 and higher. For Azure SQL Database, preview support for [publish](#publish-import-data) is available in SqlPackage 170.1.61 and higher. SQL Server 2019 and earlier isn't supported. The [import](sqlpackage-import.md) and [export](sqlpackage-export.md) actions continue to be available for SQL Server, Azure SQL Managed Instance, and Azure SQL Database. Support for Parquet files in Azure Blob Storage continues to be generally available for [Azure Synapse Analytics](sqlpackage-for-azure-synapse-analytics.md).
26+
2527
In SQL databases hosted in Azure, the extract/publish operations with Parquet files offer improved performance over import/export operations with `.bacpac` files in many scenarios.
2628

2729
## Extract (export data)
@@ -75,7 +77,7 @@ See [SqlPackage publish](sqlpackage-publish.md#examples) for more examples of au
7577

7678
### PolyBase
7779

78-
[PolyBase](../../relational-databases/polybase/polybase-guide.md) is required for SqlPackage operations with Parquet files. The following query can be used to check if PolyBase is enabled:
80+
For SQL Server and Azure SQL Managed Instance, [PolyBase](../../relational-databases/polybase/polybase-guide.md) is required for SqlPackage operations with Parquet files. The following query can be used to check if PolyBase is enabled:
7981

8082
```sql
8183
// configuration_id = 16397 is 'allow polybase export'

0 commit comments

Comments
 (0)