Merge pull request #29954 from dzsquared/sqlpackage-162_2

sqlpackage 162.2

Author: JamesJBarnett

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

@@ -142,6 +142,7 @@ SqlPackage {parameters}{properties}{SQLCMD Variables}
 |**/p:**|IncludeTransactionalScripts=(BOOLEAN)|Specifies whether transactional statements should be used where possible when you publish to a database.|
 |**/p:**|LongRunningCommandTimeout=(INT32 '0')| Specifies the long running command timeout in seconds when executing queries against SQL Server. Use 0 to wait indefinitely.|
 |**/p:**|NoAlterStatementsToChangeClrTypes=(BOOLEAN)|Specifies that publish should always drop and re-create an assembly if there is a difference instead of issuing an ALTER ASSEMBLY statement. |
+|**/p:**|PerformIndexOperationsOnline=(BOOLEAN 'False')|Specifies whether to perform index operations online during deployment.|
 |**/p:**|PopulateFilesOnFileGroups=(BOOLEAN 'True')|Specifies whether a new file is also created when a new FileGroup is created in the target database. |
 |**/p:**|RegisterDataTierApplication=(BOOLEAN)|Specifies whether the schema is registered with the database server. 
 |**/p:**|RunDeploymentPlanExecutors=(BOOLEAN)|Specifies whether DeploymentPlanExecutor contributors should be run when other operations are executed.|

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

@@ -4,7 +4,7 @@ description: "Download and Install SqlPackage for Windows, macOS, or Linux"
 author: "dzsquared"
 ms.author: "drskwier"
 ms.reviewer: "maghan"
-ms.date: 1/9/2024
+ms.date: 2/27/2024
 ms.service: sql
 ms.subservice: tools-other
 ms.topic: conceptual
@@ -17,9 +17,9 @@ ms.custom:
 
 SqlPackage runs on Windows, macOS, and Linux, and is available to install through `dotnet tool` or as a standalone zip download.
 
-- **Version number:** 162.1.172
-- **Build number:** 162.1.172.1
-- **Release date:** January 9, 2024
+- **Version number:** 162.2.111
+- **Build number:** 162.2.111.2
+- **Release date:** February 27, 2024
 
 For details about the latest release, see the [release notes](release-notes-sqlpackage.md).
 
@@ -54,25 +54,31 @@ To uninstall SqlPackage, run the following command:
 
 ### Preview releases
 
-Preview releases of SqlPackage are available with the dotnet tool feed. To install a preview release, use the `--version` option with the `dotnet tool install` command. For example, to install version 162.2.82-preview of SqlPackage, run the following command:
+Preview releases of SqlPackage are available with the dotnet tool feed. To access preview releases, use the `--prerelease` option with the `dotnet tool` command. For example, to install the latest preview release, run the following command:
 
    ```bash
-   dotnet tool install -g microsoft.sqlpackage --version 162.2.82-preview
+   dotnet tool install -g --prerelease microsoft.sqlpackage
    ```
 
-The dotnet tool `update` command won't update to a preview release. To update to a preview release, use the `--version` option with the `dotnet tool install` command. A list of releases is available on the [dotnet tool feed](https://www.nuget.org/packages/microsoft.sqlpackage/).
+To update SqlPackage to the latest preview version, run the following command:
+
+   ```bash
+   dotnet tool update -g --prerelease microsoft.sqlpackage
+   ```
+
+A list of preview releases is available on the [dotnet tool feed for SqlPackage](https://www.nuget.org/packages/microsoft.sqlpackage/).
 
 
-## Installation, zip download (alternative)
+## Installation, file download (alternative)
 
 SqlPackage is also prepared as a self-contained download for Windows, macOS, and Linux. No .NET install is required, however, the dependencies included in this .zip download are updated more frequently in the dotnet tool option for SqlPackage. The following links are for the latest version of SqlPackage:
 
 |Platform|Download|
 |:---|:---|
-|Windows .NET 6 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2257374)|
-|Windows|[MSI Installer](https://go.microsoft.com/fwlink/?linkid=2257373)|
-|macOS .NET 6 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2257375)|
-|Linux .NET 6 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2257477)|
+|Windows .NET 6 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2261576)|
+|Windows|[.msi file](https://go.microsoft.com/fwlink/?linkid=2262108)|
+|macOS .NET 6 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2261849)|
+|Linux .NET 6 |[.zip file](https://go.microsoft.com/fwlink/?linkid=2261577)|
 
 
 ### Linux
@@ -219,17 +225,17 @@ SqlPackage runs on Windows, macOS, and Linux and is built using .NET 6. The [.NE
 
 This release of SqlPackage can be installed in the following languages:
 
-SqlPackage .NET 6 Windows:  
-[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2257374&clcid=0x40a)
+SqlPackage .NET 8 Windows:  
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2261576&clcid=0x40a)
 
 SqlPackage .NET Framework Windows:  
-[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2257373&clcid=0x40a)
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2262108&clcid=0x40a)
 
-SqlPackage .NET 6 macOS:  
-[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2257375&clcid=0x40a)
+SqlPackage .NET 8 macOS:  
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2261849&clcid=0x40a)
 
-SqlPackage .NET 6 Linux:  
-[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2257477&clcid=0x40a)
+SqlPackage .NET 8 Linux:  
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2261577&clcid=0x40a)
 
 
 ## Next Steps

docs/tools/sqlpackage/sqlpackage-download.md

@@ -216,6 +216,7 @@ SqlPackage /at:$($AccessToken_Object.Token) /Action:Publish /SourceFile:"C:\Adve
 |**/p:**|IsAlwaysEncryptedParameterizationEnabled=(BOOLEAN 'False')|Enables variable parameterization on Always Encrypted columns in pre/post deployment scripts.|
 |**/p:**|LongRunningCommandTimeout=(INT32 '0')|Specifies the long running command timeout in seconds when executing queries against SQL Server. Use 0 to wait indefinitely.|
 |**/p:**|NoAlterStatementsToChangeClrTypes=(BOOLEAN 'False')|Specifies that publish should always drop and re-create an assembly if there is a difference instead of issuing an ALTER ASSEMBLY statement.|
+|**/p:**|PerformIndexOperationsOnline=(BOOLEAN 'False')|Specifies whether to perform index operations online during deployment.|
 |**/p:**|PopulateFilesOnFileGroups=(BOOLEAN 'True')|Specifies whether a new file is also created when a new FileGroup is created in the target database.|
 |**/p:**|PreserveIdentityLastValues=(BOOLEAN 'False')|Specifies whether last values for identity columns should be preserved during deployment.|
 |**/p:**|RebuildIndexesOfflineForDataPhase=(BOOLEAN 'False')|Rebuild indexes offline after importing data.|

docs/tools/sqlpackage/sqlpackage-publish.md

@@ -158,6 +158,7 @@ SqlPackage {parameters}{properties}{SQLCMD Variables}
 |**/p:**|IsAlwaysEncryptedParameterizationEnabled=(BOOLEAN 'False')|Enables variable parameterization on Always Encrypted columns in pre/post deployment scripts.|
 |**/p:**|LongRunningCommandTimeout=(INT32 '0')| Specifies the long running command timeout in seconds when executing queries against SQL Server. Use 0 to wait indefinitely.|
 |**/p:**|NoAlterStatementsToChangeClrTypes=(BOOLEAN)|Specifies that publish should always drop and re-create an assembly if there is a difference instead of issuing an ALTER ASSEMBLY statement.|
+|**/p:**|PerformIndexOperationsOnline=(BOOLEAN 'False')|Specifies whether to perform index operations online during deployment.|
 |**/p:**|PopulateFilesOnFileGroups=(BOOLEAN 'True')|Specifies whether a new file is also created when a new FileGroup is created in the target database.|
 |**/p:**|PreserveIdentityLastValues=(BOOLEAN 'False')|Specifies whether last values for identity columns should be preserved during deployment.|
 |**/p:**|RegisterDataTierApplication=(BOOLEAN)|Specifies whether the schema is registered with the database server.|

docs/tools/sqlpackage/sqlpackage-script.md

@@ -12,7 +12,7 @@ ms.custom: tools|sos
 
 # SqlPackage with data in Parquet files (preview)
 
-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. 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).
+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).
 
 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. [CETAS](../../t-sql/statements/create-external-table-as-select-transact-sql.md) is used to write the files in Azure Blob Storage.