|
| 1 | +--- |
| 2 | +title: Azure SQL Migration extension for Azure Data Studio |
| 3 | +description: This article describes how you can migrate your data using the Azure SQL migration extension with Azure Data Studio. |
| 4 | +ms.prod: azure-data-studio |
| 5 | +ms.technology: azure-data-studio |
| 6 | +ms.topic: conceptual |
| 7 | +author: markingmyname |
| 8 | +ms.author: maghan |
| 9 | +ms.reviewer: mokabiru, chadam |
| 10 | +ms.custom: |
| 11 | +ms.date: 07/30/2021 |
| 12 | +--- |
| 13 | + |
| 14 | +# Azure SQL Migration extension for Azure Data Studio (preview) |
| 15 | + |
| 16 | +The Azure SQL Migration extension for [Azure Data Studio](../what-is-azure-data-studio.md) enables you to use the SQL Server assessment and migration capability in Azure Data Studio. |
| 17 | + |
| 18 | +[!INCLUDE [database-migration-services-sql-mi-sql-vm](../../includes/database-migration-services-sql-mi-sql-vm.md)] |
| 19 | + |
| 20 | +This article describes how to install the Azure SQL migration extension through Azure Data Studio. |
| 21 | + |
| 22 | +## Prerequisites |
| 23 | + |
| 24 | +If you don't have an Azure subscription, create a [free Azure account](https://azure.microsoft.com/free/) before you begin. |
| 25 | + |
| 26 | +The following prerequisites are also required to install this extension: |
| 27 | + |
| 28 | +- [Azure Data Studio installed](../download-azure-data-studio.md). |
| 29 | + |
| 30 | +## Install the Azure SQL Migration extension |
| 31 | + |
| 32 | +To install the Azure SQL Migration extension in Azure Data Studio, follow the steps below. |
| 33 | + |
| 34 | +1. Open the extensions manager in Azure Data Studio. You can either select the extensions icon or select **Extensions** in the View menu. |
| 35 | + |
| 36 | + :::image type="content" source="media/azure-sql-migration-extension/extension-icon.png" alt-text="Extension icon"::: |
| 37 | + |
| 38 | +2. Type in *Azure SQL Migration* in the search bar. |
| 39 | + |
| 40 | +3. Select the **Azure SQL Migration** extension and view its details. |
| 41 | + |
| 42 | +4. Select **Install**. |
| 43 | + |
| 44 | + :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-extension-market-place.png" alt-text="Azure SQl Migration extension from market place"::: |
| 45 | + |
| 46 | +5. You can see the Azure SQL Migration extension in the extension list once installed. |
| 47 | + |
| 48 | + :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-icon.png" alt-text="Azure SQL migration extension"::: |
| 49 | + |
| 50 | +6. You can connect to the SQL Server instance in Azure Data Studio. Right-select the instance name and select **Manage** to see the instance dashboard and the **Azure SQL Migration** extension landing page. |
| 51 | + |
| 52 | + :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-extension-landing-page.png" alt-text="Landing page"::: |
| 53 | + |
| 54 | +> [!NOTE] |
| 55 | +> The Azure SQL Migration extension requires Azure Data Studio on a Windows operating system. |
| 56 | +
|
| 57 | +### Set up auto update for the extension |
| 58 | + |
| 59 | +[!INCLUDE [auto-update-extension](../../includes/auto-update-extension.md)] |
| 60 | + |
| 61 | +## Features |
| 62 | + |
| 63 | +### Azure SQL target readiness assessment and database migrations |
| 64 | + |
| 65 | +The Azure SQL Migration extension supports target readiness and database migrations for the following Azure SQL targets. |
| 66 | + |
| 67 | +- SQL Server on Azure Virtual Machines (SQL VM) |
| 68 | +- Azure SQL Managed Instance (SQL MI) |
| 69 | + |
| 70 | +### Migration modes |
| 71 | + |
| 72 | +The following migration modes are supported for the corresponding Azure SQL targets. |
| 73 | + |
| 74 | +- **Online** - The source SQL Server database is available for read and write activity while database backups are continuously restored on target Azure SQL. Application downtime is limited to duration for the cutover at the end of migration. |
| 75 | +- **Offline** - The source database cannot be used for write activity while database backup files are restored on the target Azure SQL database. Application downtime persists through the start until the completion of the migration process. |
| 76 | + |
| 77 | +### Support matrix |
| 78 | + |
| 79 | +| Azure SQL target | Migration mode | |
| 80 | +|-----------------|----------------| |
| 81 | +| Azure SQL Managed Instance | Online | |
| 82 | +| Azure SQL Managed Instance | Offline | |
| 83 | +| SQL Server on Azure VM | Online | |
| 84 | +| SQL Server on Azure VM | Offline | |
| 85 | + |
| 86 | +> [!TIP] |
| 87 | +> For information on pre-requisites, features and migration workflow, see [Migration using Azure Data Studio](/azure/dms/migration-using-azure-data-studio) |
| 88 | +
|
| 89 | +### Get help from Microsoft support |
| 90 | + |
| 91 | +You can raise a support request for a Microsoft engineer to assist if you encounter issues or errors with your database migrations using this extension. |
| 92 | + |
| 93 | +Select **New support request** on the extension to navigate to the Azure portal where you can submit a support request. |
| 94 | +:::image type="content" source="media/azure-sql-migration-extension/extension-support.png" alt-text="Get help from Microsoft support for the extension"::: |
| 95 | + |
| 96 | +> [!NOTE] |
| 97 | +> Select the **Feedback** button if you have any suggestions or feedback to improve the extension. |
| 98 | +
|
| 99 | +## Next steps |
| 100 | + |
| 101 | +- [Database migrations using Azure Data Studio](/azure/dms/migration-using-azure-data-studio) |
| 102 | +- [Download Azure Data Studio](../download-azure-data-studio.md) |
| 103 | +- [Azure Data Studio release notes](../release-notes-azure-data-studio.md) |
| 104 | +- [Azure Data Studio extensions](add-extensions.md) |
0 commit comments