Skip to content

Commit 12897d7

Browse files
Merge pull request #34619 from blakhani-msft/docs-editor/convert-to-hyperscale-1751913737
Added content about client connection termination in phase 1 (BC/Premium to HS conversion)
2 parents 53c05b4 + f8beb15 commit 12897d7

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

azure-sql/database/convert-to-hyperscale.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: How to convert an Azure SQL Database to the Hyperscale tier.
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: dfurman, blakhani
7-
ms.date: 07/02/2025
7+
ms.date: 07/07/2025
88
ms.service: azure-sql-database
99
ms.topic: how-to
1010
ms.custom:
@@ -42,9 +42,13 @@ The conversion process is divided into two stages - the conversion of database,
4242

4343
- The time required to move an existing database to Hyperscale consists of the time to copy data and the time to replay the changes made in the source database while copying data. The data copy time is proportional to data size. We recommend converting to Hyperscale during a lower write activity period so that the time to replay accumulated changes is shorter.
4444
- You have the ability to choose when the cutover occurs - as soon as the database is ready, or manually at a time of your choosing. By default, the process to convert to Hyperscale will cutover automatically.
45-
- If you choose to manually cutover at a time of your choosing, you have 24 hours to initiate a manual cutover after the point when the database ready for cutover. You can initiate a manual cutover via the Azure portal, Azure CLI, PowerShell, or T-SQL.
45+
- If you choose to manually cutover at a time of your choosing, you have 24 hours to initiate a manual cutover after the point when the database ready for cutover. You can initiate a manual cutover via the Azure portal, Azure CLI, PowerShell, or T-SQL.
4646
- During the final cutover to Hyperscale, your applications only experience a short period of downtime, usually less than a minute.
4747

48+
There are multiple phases in the conversion process which can be monitored in the Azure portal (on the progress reporting page), via Azure CLI ([az sql db op list](/cli/azure/sql/db/op#az-sql-db-op-list)), PowerShell ([Get-AzSqlDatabaseActivity](/powershell/module/az.sql/get-azsqldatabaseactivity)), or using T-SQL ([sys.dm_operation_status](/sql/relational-databases/system-dynamic-management-views/sys-dm-operation-status-azure-sql-database)).
49+
50+
When converting a database from the Premium or Business Critical service tiers to Hyperscale, existing client connections are disconnected during phase 1. This is similar to the disconnect that occurs when scaling the database between service tiers. Applications should be designed to gracefully handle transient connectivity interruptions by implementing retry logic as described in [Retry logic for transient errors](/azure/azure-sql/database/troubleshoot-common-connectivity-issues#retry-logic-for-transient-errors).
51+
4852
## Convert a database to Hyperscale
4953

5054
To convert an existing Azure SQL Database to Hyperscale, first identify your target service objective.

0 commit comments

Comments
 (0)