Skip to content

Commit 1764778

Browse files
authored
Migrate to SQL VM through the Azure portal (#37023)
1 parent 00903f4 commit 1764778

27 files changed

Lines changed: 514 additions & 52 deletions

azure-sql/managed-instance/log-replay-service-migrate.md

Lines changed: 21 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Migrate SQL Server databases to Azure SQL Managed Instance by using
44
author: danimir
55
ms.author: danil
66
ms.reviewer: mathoma, randolphwest
7-
ms.date: 09/17/2025
7+
ms.date: 04/16/2026
88
ms.service: azure-sql-managed-instance
99
ms.subservice: migration
1010
ms.topic: how-to
@@ -185,34 +185,33 @@ You can use an Azure Blob Storage account as intermediary storage for backup fil
185185

186186
Follow these steps to generate the token:
187187

188-
1. In the Azure portal, open **Storage Explorer**.
189-
1. Expand **Blob Containers**.
190-
1. Right-click the blob container, and then select **Get Shared Access Signature**.
188+
1. Go to the [Storage center](https://portal.azure.com/#view/Microsoft_Azure_StorageHub/StorageHub.MenuView/~/StorageAccountsBrowse) in the Azure portal and select your storage account.
189+
1. Under **Security + networking**, select **Shared access signature** to open the **Shared access signature** pane.
190+
1. On the **Shared access signature** pane, configure the settings to generate a SAS token for LRS. Use the following guidelines to configure the settings:
191+
1. **Allowed services**: **Blob** and **File**.
192+
1. **Allowed resource types**: **Service**.
193+
1. **Permissions**: **Read** and **List** only.
191194

192-
:::image type="content" source="media/log-replay-service-migrate/lrs-sas-token-01.png" alt-text="Screenshot that shows selections for generating a SAS authentication token." lightbox="media/log-replay-service-migrate/lrs-sas-token-01.png":::
195+
> [!IMPORTANT]
196+
> Don't select any other permissions. If you do, LRS won't start. This security requirement is by design.
193197
194-
1. Select the time frame for token expiration. Ensure that the token is valid during your migration.
198+
1. **Blob versioning permissions**: Optional
199+
1. **Allowed blob index permissions**: Can be disabled.
200+
1. Select the time zone for the token: UTC or your local time.
201+
202+
> [!IMPORTANT]
203+
> The time zone of the token and your managed instance might mismatch. Ensure that the SAS token has the appropriate time validity, taking time zones into consideration. To account for time zone differences, set the validity **From** value well before your migration window starts, and the **To** value well after you expect your migration to finish.
195204
196-
1. Select the time zone for the token: UTC or your local time.
197-
198-
> [!IMPORTANT]
199-
> The time zone of the token and your managed instance might mismatch. Ensure that the SAS token has the appropriate time validity, taking time zones into consideration. To account for time zone differences, set the validity **From** value well before your migration window starts, and the **To** value well after you expect your migration to finish.
200-
201-
1. Select **Read** and **List** permissions only.
202-
203-
> [!IMPORTANT]
204-
> Don't select any other permissions. If you do, LRS won't start. This security requirement is by design.
205-
206-
1. Select **Create**.
205+
1. Select **Generate SAS and connection string** to generate the token:
207206

208207
:::image type="content" source="media/log-replay-service-migrate/lrs-sas-token-02.png" alt-text="Screenshot that shows selections for SAS token expiration, time zone, and permissions, along with the Create button." lightbox="media/log-replay-service-migrate/lrs-sas-token-02.png":::
209208

210-
The SAS authentication is generated with the time validity that you specified. You need the URI version of the token, as shown in the following screenshot:
209+
The SAS authentication is generated with the time validity that you specified.
211210

212-
:::image type="content" source="media/log-replay-service-migrate/lrs-generated-uri-token.png" alt-text="Screenshot that shows an example of the URI version of a SAS token.":::
211+
1. Copy the value provided in the **Blob Service SAS URL** field, which is the URI version of the token that you need to start LRS.
213212

214-
> [!NOTE]
215-
> Using SAS tokens created with permissions that were set by defining a [stored access policy](/rest/api/storageservices/define-stored-access-policy) isn't supported at this time. Follow the instructions in this procedure to manually specify **Read** and **List** permissions for the SAS token.
213+
> [!NOTE]
214+
> Using SAS tokens created with permissions that were set by defining a [stored access policy](/rest/api/storageservices/define-stored-access-policy) isn't supported at this time. Follow the instructions in this procedure to manually specify **Read** and **List** permissions for the SAS token.
216215
217216
### Copy parameters from the SAS token
218217

@@ -230,12 +229,8 @@ Copy the parameters as follows:
230229

231230
1. Copy the first part of the token, from `https://` up to but not including the question mark (`?`). Use it as the `StorageContainerUri` parameter in PowerShell or the Azure CLI when you're starting LRS.
232231

233-
:::image type="content" source="media/log-replay-service-migrate/lrs-token-uri-copy-part-01.png" alt-text="Screenshot that shows where to copy the first part of the token." lightbox="media/log-replay-service-migrate/lrs-token-uri-copy-part-01.png":::
234-
235232
1. Copy the second part of the token, from after the question mark (`?`) through the end of the string. Use it as the `StorageContainerSasToken` parameter in PowerShell or the Azure CLI when you're starting LRS.
236233

237-
:::image type="content" source="media/log-replay-service-migrate/lrs-token-uri-copy-part-02.png" alt-text="Screenshot that shows where to copy the second part of the token." lightbox="media/log-replay-service-migrate/lrs-token-uri-copy-part-02.png":::
238-
239234
> [!NOTE]
240235
> Don't include the question mark (`?`) when you copy either part of the token.
241236
@@ -270,7 +265,7 @@ Next, connect to your managed instance, and run a sample test query to determine
270265
If you're using a SAS token to authenticate to your storage account, then replace the `<sastoken>` with your SAS token and run the following query on your instance:
271266

272267
```sql
273-
CREATE CREDENTIAL [https://mitutorials.blob.core.windows.net/databases]
268+
CREATE CREDENTIAL [https://<mystorageaccountname>.blob.core.windows.net/databases]
274269
WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
275270
SECRET = '<sastoken>';
276271

@@ -635,7 +630,6 @@ Consider the following limitations when migrating with LRS:
635630
- If [accelerated database recovery](/sql/relational-databases/accelerated-database-recovery-concepts) is disabled on your source SQL Server 2019 and later instances, you can no longer enable it after migrating to Azure SQL Managed Instance. Additionally, if the persistent version store (PVS) isn't set to `PRIMARY`, you can experience issues with restore operations on the target SQL managed instance.
636631
- If [Service Broker](/sql/database-engine/configure-windows/sql-server-service-broker) is disabled on the source SQL Server instance, you can't use Service Broker on the target SQL managed instance after migration.
637632

638-
639633
> [!NOTE]
640634
> If you require a database to be read-only accessible during the migration, with a much longer time frame for performing the migration and with minimal downtime, consider using the [Overview of the Managed Instance link](managed-instance-link-feature-overview.md) feature as a recommended migration solution.
641635
Binary file not shown.
Binary file not shown.
20.6 KB
Loading
-539 Bytes
Loading
Binary file not shown.
Binary file not shown.

azure-sql/virtual-machines/windows/doc-changes-updates-release-notes-whats-new.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn about the new features for and improvements to SQL Server on
44
author: MashaMSFT
55
ms.author: mathoma
66
ms.reviewer: randolphwest, dpless
7-
ms.date: 04/01/2026
7+
ms.date: 04/16/2026
88
ms.service: azure-vm-sql-server
99
ms.topic: whats-new
1010
ms.custom:
@@ -37,6 +37,7 @@ The following table lists the features of SQL Server on Azure VMs that are curre
3737
| Feature | Details |
3838
| --- | --- |
3939
| [Modernization Advisor](../modernization-advisor.md) | Use the Modernization Advisor in the Azure portal to help you determine if migrating to Azure SQL Managed Instance saves you money or optimizes performance. |
40+
| [Migration from the Azure portal](/sql/sql-server/azure-arc/migrate-to-sql-server-on-azure-vms) | Migrate your SQL Server databases to SQL Server on Azure VMs directly from the Azure portal. |
4041
| [Premium SSD v2 in the Azure portal](storage-configuration-premium-ssd-v2.md) | Deploy your SQL Server on Azure VM with Premium SSD v2 disks in the Azure portal for improved throughput and performance. |
4142
| [Unified inventory](unified-inventory-sql-vm.md) | View your SQL Server on Azure VM and SQL Server enabled by Azure Arc resources in a single pane in the Azure portal. With unified inventory, you can view your *SQL Server instance* resources, making it easier to monitor and maintain your SQL Server workloads in Azure. |
4243
| [VM vCore customization](vm-vcore-customization-for-sql.md) |Customize the number of vCPUs presented to the guest OS for SQL Server workloads with configurable constrained cores (CCC), and disable Simultaneous Multithreading (SMT). This capability allows you to appropriately size the vCPU count to match your SQL Server licensing needs while preserving the VM's memory and I/O capabilities. |
@@ -60,6 +61,7 @@ Learn about significant changes to the SQL Server on Azure VMs documentation. Fo
6061

6162
| Changes | Details |
6263
| --- | --- |
64+
| **Migration through the Azure portal preview**| Migrate your SQL Server databases to SQL Server on Azure VMs directly from the Azure portal. This feature is currently in preview. To learn more, see [Migration from the Azure portal](/sql/sql-server/azure-arc/migrate-to-sql-server-on-azure-vms). |
6365
| **SQL Server servicing and updates guidance** | New article that describes the supported methods to keep SQL Server up to date on Azure VMs, including Azure Update Manager, Automated Patching, custom images, winget for client tools, and post-deployment automation. SQL Server images from Azure Marketplace are deployed at RTM and aren't updated over time. For more information, see [Updating SQL Server on Azure VMs](servicing-updates-guidelines.md). |
6466

6567
### March 2026
40.3 KB
Loading
60.4 KB
Loading

0 commit comments

Comments
 (0)