Skip to content

Commit c5013c9

Browse files
authored
Merge pull request #21065 from dzsquared/dacfx-160ga
draft docs
2 parents 51d92e0 + 94afb2c commit c5013c9

4 files changed

Lines changed: 97 additions & 47 deletions

File tree

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

Lines changed: 70 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: DacFx and SqlPackage release notes
33
description: Release notes for Microsoft sqlpackage.
44
ms.custom: "tools|sos"
5-
ms.date: 10/04/2021
5+
ms.date: 01/25/2022
66
ms.prod: sql
77
ms.reviewer: "llali"
88
ms.prod_service: sql-tools
@@ -16,6 +16,49 @@ ms.author: drskwier
1616

1717
This article lists the features and fixes delivered by the released versions of SqlPackage.exe.
1818

19+
## 19.0 sqlpackage
20+
21+
|Platform|Download|Release date|Version|Build
22+
|:---|:---|:---|:---|:---|
23+
|Windows|[MSI Installer](https://go.microsoft.com/fwlink/?linkid=2185764)|January 25, 2022|19.0|16.0.5400.1|
24+
|macOS .NET Core |[.zip file](https://go.microsoft.com/fwlink/?linkid=2185765)|January 25, 2022| 19.0|16.0.5400.1|
25+
|Linux .NET Core |[.zip file](https://go.microsoft.com/fwlink/?linkid=2185670)|January 25, 2022| 19.0|16.0.5400.1|
26+
|Windows .NET Core |[.zip file](https://go.microsoft.com/fwlink/?linkid=2185669)|January 25, 2022| 19.0|16.0.5400.1|
27+
28+
29+
### Features
30+
| Feature | Details |
31+
| :------ | :------ |
32+
|Always Encrypted|Adds support for in-place encryption for Always Encrypted columns. Publish can now leverage a server-side secure enclave to encrypt, decrypt, and re-encrypt database columns in-place. This avoids the expense of moving the data outside of the database. See pre-requisites for in-place encryption in [Configure column encryption in-place using Always Encrypted with secure enclaves](../../relational-databases/security/encryption/always-encrypted-enclaves-configure-encryption.md). Note: In-place encryption is supported only with the offline approach. |
33+
|Azure Synapse Analytics|Adds support for column-level symmetric encryption.|
34+
|Ledger|Adds supports for exporting and importing databases with ledger tables. The following limitations apply to Export: Ledger history tables and dropped ledger tables aren't migrated; the values of `GENERATED ALWAYS` columns and the data in ledger system views isn't migrated; the value of the database-level Ledger property is ignored.|
35+
|Platform|Adds support for .NET 6 as the target framework|
36+
|Platform|References Microsoft.Data.SqlClient (3.0) instead of System.Data.SqlClient in .NET Framework version. Upgrade Microsoft.Data.SqlClient from 2.1.3 to 3.0 for .NET Core version.|
37+
|Platform|Upgrades .NET Framework target version to .NET 4.6.2|
38+
|ScriptDOM|Adds support for Sql160 parser.|
39+
40+
41+
42+
### Fixes
43+
| Feature | Details |
44+
| :------ | :------ |
45+
| Deployment |Fixes issue with interpretation of table distribution on column within a stored procedure. |
46+
| Deployment |Fixes issue with "Drop objects not in source" option during publish operation. |
47+
| Deployment |Fixes for Deploying a dacpac with temporal table having sensitivity classification. |
48+
| Deployment |Fixes a bug when variables are verified even when DoNotEvaluateSqlCmdVariables is set to true|
49+
| Extract |Fix for Refactor log of referenced dacpac according to includeCompositeObjects selection. |
50+
| Import |Fixes issue with importing database scope configurations that are not supported in target server|
51+
| SQL Project |Fixes issue where incremental statistics caused an issue with the project build when applied to a primary key. |
52+
| SQL Project |Fixes building a project with file tables. |
53+
54+
55+
### Known Issues
56+
| Feature | Details | Workaround |
57+
| :------ | :------ |:------ |
58+
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) isn't yet supported. | N/A |
59+
| Deployment | The Azure SQL ledger table feature isn't yet supported for extract and publish. | N/A |
60+
61+
1962
## 18.8 sqlpackage
2063

2164
|Platform|Download|Release date|Version|Build
@@ -30,7 +73,7 @@ This article lists the features and fixes delivered by the released versions of
3073
| Feature | Details |
3174
| :------ | :------ |
3275
| Export | Adds option VerifyExtraction to change behavior of schema model validation on export |
33-
| Azure SQL | Support for ledger database and tables, import and export |
76+
| Azure SQL | Support for ledger database and tables, including import and export actions. |
3477
| Platform | Upgrade Microsoft.Data.SqlClient from 2.0.0 to 2.1.3 for .NET Core version |
3578
| Azure Synapse Analytics | Support for column encryption with symmetric key |
3679
| Azure Synapse Analytics | Support for column encryption with CREATE CERTIFICATE |
@@ -48,7 +91,7 @@ This article lists the features and fixes delivered by the released versions of
4891
| Deployment | Fix for deployment order involving temporal tables to drop dependencies before turning system versioning off |
4992
| Deployment | Fix for Always Encrypted deployment bug with error "Invalid object name '#tmpErrors'" |
5093
| Export | Validation for SqlPackage parameters ExcludeObjectType(s) and DoNotDropObjectType(s) |
51-
| Export | Fixed export failure when there are CDC objects in database by excluding |
94+
| Export | Fixed export failure when there are change data capture (CDC) objects in database by excluding |
5295
| Extract | Adds a retry to extract validation when first time fails due to race condition |
5396
| Import | Fixed occasional deadlocks when importing to Azure by setting MAXDOP to 1 |
5497
| Import | Fixed import failure when temporal table has dependency on security policy with schema binding on |
@@ -64,8 +107,8 @@ This article lists the features and fixes delivered by the released versions of
64107
### Known Issues
65108
| Feature | Details | Workaround |
66109
| :------ | :------ |:------ |
67-
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) is not yet supported | N/A |
68-
| Deployment | The Azure SQL ledger table feature is not yet supported | N/A |
110+
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) isn't yet supported | N/A |
111+
| Deployment | The Azure SQL ledger table feature isn't yet supported | N/A |
69112

70113
## 18.7.1 sqlpackage
71114

@@ -87,7 +130,7 @@ This article lists the features and fixes delivered by the released versions of
87130
| Feature | Details |
88131
| :------ | :------ |
89132
| Export | Fixed an issue where exporting a table with text or image in the first column would fail without a clustered index. |
90-
| Export | Fixed an issue where exporting a table that has the order of columns in a statistic in a different order than the table create script would fail without a clustered index. |
133+
| Export | Fixed an issue where exporting a table without a clustered index that has the order of columns in a statistic in a different order than the table create script would fail. |
91134

92135
## 18.7 sqlpackage
93136

@@ -102,7 +145,7 @@ This article lists the features and fixes delivered by the released versions of
102145
| Feature | Details |
103146
| :------ | :------ |
104147
| Deployment | Extract/Publish Big Data to/from Azure Storage. For more info, see [SqlPackage for Big Data](sqlpackage-for-azure-synapse-analytics.md) |
105-
| Azure Synapse Analytics | Row level security support (inline table valued function, security policy, security predicate) |
148+
| Azure Synapse Analytics | Row level security support (inline table-valued function, security policy, security predicate) |
106149
| Azure Synapse Analytics | Workload classification support |
107150
| Azure SQL Edge | External streaming job support |
108151
| Azure SQL Edge | Added table and database options for data retention. |
@@ -134,8 +177,8 @@ This article lists the features and fixes delivered by the released versions of
134177
### Known Issues
135178
| Feature | Details | Workaround |
136179
| :------ | :------ |:------ |
137-
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) is not yet supported | N/A |
138-
| Deployment | In an incremental deploy scenario when the user is dropping a temporal table along with dropping objects that are dependent on it, like functions, stored procs etc. the deployment can fail. The script generation order tries to turn off SYSTEM_VERSIONING on the table which is a pre-req for dropping the table, but the order of steps generated is incorrect. [Work item](https://github.com/microsoft/azuredatastudio/issues/14655) | Generate the deployment script, move the System_Versioning OFF step to just before the table being dropped and then run the script. |
180+
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) isn't yet supported | N/A |
181+
| Deployment | In an incremental deploy scenario, when the user is dropping a temporal table along with dropping objects that are dependent on it, like functions, stored procedures etc. the deployment can fail. The script generation order tries to turn off SYSTEM_VERSIONING on the table that is a pre-req for dropping the table, but the order of generated steps is incorrect. [Work item](https://github.com/microsoft/azuredatastudio/issues/14655) | Generate the deployment script, move the System_Versioning OFF step to just before the table being dropped and then run the script. |
139182

140183
## 18.6 sqlpackage
141184

@@ -170,7 +213,7 @@ This article lists the features and fixes delivered by the released versions of
170213
### Known Issues
171214
| Feature | Details |
172215
| :------ | :------ |
173-
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) is not yet supported |
216+
| Deployment | The Azure Synapse Analytics Workload Management feature (Workload Groups and Workload Classifiers) isn't yet supported |
174217

175218
## 18.5.1 sqlpackage
176219

@@ -184,7 +227,7 @@ This article lists the features and fixes delivered by the released versions of
184227
### Fixes
185228
| Feature | Details |
186229
| :------ | :------ |
187-
| Deployment | Fixed a regression that was introduced in 18.5 causing there to be an Incorrect syntax near 'type' error when deploying a dacpac or importing a bacpac with a user with external login to on premise |
230+
| Deployment | Fixed a regression that was introduced in 18.5 causing there to be an "Incorrect syntax near 'type'" error when deploying a dacpac or importing a bacpac with a user with external login to on premise |
188231

189232
## 18.5 sqlpackage
190233

@@ -201,7 +244,7 @@ This article lists the features and fixes delivered by the released versions of
201244
| Deployment | Data Sensitivity classification now supported for SQL Server 2008 and up, Azure SQL Database, and Azure Synapse Analytics |
202245
| Deployment | Add Azure Synapse Analytics support for table constraints |
203246
| Deployment | Add Azure Synapse Analytics support for ordered clustered column store index |
204-
| Deployment | Add support for External Data Source (for Oracle, Teradata, MongoDB/CosmosDB, ODBC, Big Data Cluster) and External Table for SQL Server 2019 Big Data Cluster |
247+
| Deployment | Add support for External Data Source (Oracle, Teradata, MongoDB/CosmosDB, ODBC, Big Data Cluster) and External Table for SQL Server 2019 Big Data Cluster |
205248
| Deployment | Add SQL Database Edge Instance as supported edition |
206249
| Deployment | Support Managed Instance server names of the form '\<server>.\<dnszone>.database.windows.net' |
207250
| Deployment | Add support for copy command in Azure Synapse Analytics |
@@ -216,7 +259,7 @@ This article lists the features and fixes delivered by the released versions of
216259
| Deployment | Fix generating GRANT statements for AlterAnyDatabaseScopedConfiguration and AlterAnySensitivityClassification permissions |
217260
| Deployment | Fix External Script permission not being recognized |
218261
| Deployment | Fix for inline property - the implicit addition of the property should not show in difference but explicit mention should show through script |
219-
| Deployment | Resolved an issue where changing a Table referenced by a Materialized View (MV) causes Alter View statements to be generated which is not supported for MVs for Azure Synapse Analytics |
262+
| Deployment | Resolved an issue where changing a Table referenced by a Materialized View (MV) causes Alter View statements to be generated. Alter View statements are not supported for MVs for Azure Synapse Analytics. |
220263
| Deployment | Fix publish failing when adding column to a table with data for Azure Synapse Analytics |
221264
| Deployment | Fix update script should move data to a new table when changing the distribution column type (data loss scenario) for Azure Synapse Analytics |
222265
| ScriptDom | Fix ScriptDom bug where it couldn't recognize inline constraints defined after an inline index |
@@ -227,8 +270,8 @@ This article lists the features and fixes delivered by the released versions of
227270
### Known Issues
228271
| Feature | Details |
229272
| :------ | :------ |
230-
| Deployment | A regression was introduced in 18.5 causing there to be an Incorrect syntax near 'type' error when deploying a dacpac or importing a bacpac with a user with external login to on premise. Workaround is to use sqlpackage 18.4 and it will be fixed in the next sqlpackage release. |
231-
| .NET Core | Importing bacpacs with Sensitivity Classification fails with "Internal connection fatal error" because of this [known issue](https://github.com/dotnet/SqlClient/issues/559) in Microsoft.Data.SqlClient. This will be fixed in the next sqlpackage release. |
273+
| Deployment | A regression was introduced in 18.5 causing there to be an "Incorrect syntax near 'type'" error when deploying a dacpac or importing a bacpac with a user with external login to on premise. Workaround is to use sqlpackage 18.4 and it will be fixed in the next sqlpackage release. |
274+
| .NET Core | Importing bacpacs with sensitivity classification fails with "Internal connection fatal error" because of this [known issue](https://github.com/dotnet/SqlClient/issues/559) in Microsoft.Data.SqlClient. This will be fixed in the next sqlpackage release. |
232275
| &nbsp; | &nbsp; |
233276

234277
## 18.4.1 sqlpackage
@@ -250,7 +293,7 @@ This article lists the features and fixes delivered by the released versions of
250293

251294
| Feature | Details |
252295
| :------ | :------ |
253-
| Deployment | A regression was introduced in 18.4.1 causing there to be a “Object reference not set to an instance of an object. error when deploying a dacpac or importing a bacpac with a user with external login. Workaround is to use sqlpackage 18.4 and it will be fixed in the next sqlpackage release. |
296+
| Deployment | A regression was introduced in 18.4.1 causing there to be an "Object reference not set to an instance of an object." error when deploying a dacpac or importing a bacpac with a user with external login. Workaround is to use sqlpackage 18.4 and it will be fixed in the next sqlpackage release. |
254297
| &nbsp; | &nbsp; |
255298

256299
## 18.4 sqlpackage
@@ -266,8 +309,8 @@ This article lists the features and fixes delivered by the released versions of
266309

267310
| Feature | Details |
268311
| :------ | :------ |
269-
| Deployment | Add support to deploy to Azure Synapse Analytics (GA). |
270-
| Platform | sqlpackage .NET Core GA for macOS, Linux, and Windows. |
312+
| Deployment | Add support to deploy to Azure Synapse Analytics. |
313+
| Platform | sqlpackage .NET Core generally available for macOS, Linux, and Windows. |
271314
| Security | Remove SHA1 code signing. |
272315
| Deployment | Add support for new Azure database editions: GeneralPurpose, BusinessCritical, Hyperscale |
273316
| Deployment | Add Managed Instance support for Azure Active Directory user and groups. |
@@ -286,10 +329,10 @@ This article lists the features and fixes delivered by the released versions of
286329
| Feature | Details |
287330
| :------ | :------ |
288331
| Import | For .bacpac files with compressed files over 4GB in size, you might need to use the .NET Core version of sqlpackage to perform the import. This behavior is due to how .NET Core generates zip headers, which although valid, are not readable by the .NET Full Framework version of sqlpackage. |
289-
| Deployment | The parameter /p:Storage=File is not supported. Only Memory is supported on .NET Core. |
290-
| Always Encrypted | sqlpackage .NET Core does not support Always Encrypted columns. |
291-
| Security | sqlpackage .NET Core does not support the /ua parameter for multi-factor authentication. |
292-
| Deployment | Older V2 .dacpac and .bacpac files that use json data serialization aren't supported. |
332+
| Deployment | The parameter /p:Storage=File isn't supported. Only Memory is supported on .NET Core. |
333+
| Always Encrypted | sqlpackage .NET Core doesn't support Always Encrypted columns. |
334+
| Security | sqlpackage .NET Core doesn't support the /ua parameter for multi-factor authentication. |
335+
| Deployment | Older V2 dacpac and bacpac files that use json data serialization aren't supported. |
293336
| &nbsp; | &nbsp; |
294337

295338
## 18.3.1 sqlpackage
@@ -321,7 +364,7 @@ This article lists the features and fixes delivered by the released versions of
321364
| Always Encrypted | Fix for handling Always Encrypted varchar columns. |
322365
| Build/Deployment | Fix to resolve the nodes() method for xml column sets.|
323366
| ScriptDom | Fix additional cases where the 'URL' string was interpreted as a top level token. |
324-
| Graph | Fix generated TSQL for pseudo column references in constraints. |
367+
| Graph | Fix generated SQL for pseudo column references in constraints. |
325368
| Export | Generate random passwords that meet complexity requirements. |
326369
| Deployment | Fix to honor command timeouts when retrieving constraints. |
327370
| .NET Core (preview) | Fix diagnostic logging to a file. |
@@ -389,8 +432,8 @@ This release includes cross-platform preview builds of sqlpackage that target .N
389432
| Known issue | Details |
390433
| :---------- | :------ |
391434
| Deployment | For .NET Core, build and deployment contributors aren't supported. |
392-
| Deployment | For .NET Core, older .dacpac and .bacpac files that use json data serialization aren't supported. |
393-
| Deployment | For .NET Core referenced .dacpacs (for example master.dacpac) may not resolve due to issues with case-sensitive file systems. A workaround is to capitalize the name of the reference file (for example MASTER.BACPAC). |
435+
| Deployment | For .NET Core, older dacpac and bacpac files that use json data serialization aren't supported. |
436+
| Deployment | For .NET Core referenced dacpacs (for example master.dacpac) may not resolve due to issues with case-sensitive file systems. A workaround is to capitalize the name of the reference file (for example MASTER.BACPAC). |
394437
| &nbsp; | &nbsp; |
395438

396439
## 18.0 sqlpackage
@@ -458,7 +501,7 @@ Build: &nbsp; 14.0.3917.1
458501

459502
| Fix | Details |
460503
| :-- | :------ |
461-
| Import | When importing an Azure SQL Database .bacpac to an on-premises instance, fixed errors due to _Database master keys without password are not supported in this version of SQL Server_. |
504+
| Import | When importing an Azure SQL Database bacpac to an on-premises instance, fixed errors due to _Database master keys without password are not supported in this version of SQL Server_. |
462505
| Graph | Fixed an unresolved pseudo column error for graph tables. |
463506
| Schema Compare | Fixed SQL authentication to compare schemas. |
464507
| &nbsp; | &nbsp; |
@@ -481,5 +524,5 @@ Build: &nbsp; 14.0.3881.1
481524

482525
| Fix | Details |
483526
| :-- | :------ |
484-
| Deployment | Do not block when encountering a database compatibility level that is not understood. Instead, the latest Azure SQL Database or on-premises platform will be assumed. |
527+
| Deployment | Do not block when encountering a database compatibility level that isn't understood. Instead, the latest Azure SQL Database or on-premises platform will be assumed. |
485528
| &nbsp; | &nbsp; |

0 commit comments

Comments
 (0)