Migration overview: SQL Server to Azure SQL Managed Instance
Applies to: 
Azure SQL Managed Instance
Learn about the options and considerations for migrating your SQL Server databases to Azure SQL Managed Instance.
You can migrate SQL Server databases running on-premises or on:
- SQL Server on Virtual Machines
- Amazon EC2 (Elastic Compute Cloud)
- Amazon RDS (Relational Database Service) for SQL Server
- Google Compute Engine
- Cloud SQL for SQL Server - GCP (Google Cloud Platform)
For other migration guides, see Database Migration.
Overview
Azure SQL Managed Instance is a recommended target option for SQL Server workloads that require a fully managed service without having to manage virtual machines or their operating systems. SQL Managed Instance enables you to move your on-premises applications to Azure with minimal application or database changes. It offers complete isolation of your instances with native virtual network support.
Be sure to review the SQL Server database engine features available in Azure SQL Managed Instance to validate the supportability of your migration target.
Considerations
The key factors to consider when you're evaluating migration options are:
- Number of servers and databases
- Size of databases
- Acceptable business downtime during the migration process
One of the key benefits of migrating your SQL Server databases to SQL Managed Instance is that you can choose to migrate the entire instance or just a subset of individual databases. Carefully plan to include the following in your migration process:
- All databases that need to be colocated to the same instance
- Instance-level objects required for your application, including logins, credentials, SQL Agent jobs and operators, and server-level triggers
Note
Azure SQL Managed Instance guarantees 99.99 percent availability, even in critical scenarios. Overhead caused by some features in SQL Managed Instance can't be disabled. For more information, see the Key causes of performance differences between SQL Managed Instance and SQL Server blog entry.
Choose an appropriate target
You can use the Azure SQL migration extension for Azure Data Studio to get right-sized Azure SQL Managed Instance recommendation. The extension collects performance data from your source SQL Server instance to provide right-sized Azure recommendation that meets your workload's performance needs with minimal cost. To learn more, see Get Azure recommendations to migrate your SQL Server database
The following general guidelines can help you choose the right service tier and characteristics of SQL Managed Instance to help match your performance baseline:
- Use the CPU usage baseline to provision a managed instance that matches the number of cores that your instance of SQL Server uses. It might be necessary to scale resources to match the hardware configuration characteristics.
- Use the memory usage baseline to choose a vCore option that appropriately matches your memory allocation.
- Use the baseline I/O latency of the file subsystem to choose between the General Purpose (latency greater than 5 ms) and Business Critical (latency less than 3 ms) service tiers.
- Use the baseline throughput to preallocate the size of the data and log files to achieve expected I/O performance.
You can choose compute and storage resources during deployment and then change them afterward by using the Azure portal, without incurring downtime for your application.
Important
Any discrepancy in the virtual network requirements for managed instances can prevent you from creating new instances or using existing ones. Learn more about creating new and configuring existing networks.
Another key consideration in the selection of the target service tier in Azure SQL Managed Instance (General Purpose versus Business Critical) is the availability of certain features, like In-Memory OLTP, that are available only in the Business Critical tier.
SQL Server VM alternative
Your business might have requirements that make SQL Server on Azure Virtual Machines a more suitable target than Azure SQL Managed Instance.
If one of the following conditions applies to your business, consider moving to a SQL Server virtual machine (VM) instead:
- You require direct access to the operating system or file system, such as to install third-party or custom agents on the same virtual machine with SQL Server.
- You have strict dependency on features that are still not supported, such as FileStream/FileTable, PolyBase, and cross-instance transactions.
- You need to stay at a specific version of SQL Server (2012, for example).
- Your compute requirements are much lower than a managed instance offers (one vCore, for example), and database consolidation isn't an acceptable option.
Migration tools
We recommend the following migration tools:
| Technology | Description |
|---|---|
| Azure SQL Migration extension for Azure Data Studio | Powered by the Azure Database Migration service, the Azure SQL Migration extension for Azure Data Studio helps you to assess your database requirements to understand your migration readiness, get the right-sized SKU recommendations for Azure resources, and migrate your SQL Server database to Azure. You can migrate single databases or at scale using PowerShell and Azure CLI. |
| Azure Migrate | This Azure service helps you discover and assess your SQL data estate at scale on VMware. It provides Azure SQL deployment recommendations, target sizing, and monthly estimates. |
| Native backup and restore | SQL Managed Instance supports restore of native SQL Server database backups (.bak files). It's the easiest migration option for customers who can provide full database backups to Azure Storage. |
| Log Replay Service | This cloud service is enabled for SQL Managed Instance based on SQL Server log-shipping technology. It's a migration option for customers who can provide full, differential, and log database backups to Azure Storage. Log Replay Service is used to restore backup files from Azure Blob Storage to SQL Managed Instance. |
| Managed Instance link | This feature enables online migration to SQL Managed Instance by using Always On availability technology to replicate changes nearly real time. It's a migration option for customers who require the database on SQL Managed Instance to be accessible in R/O mode while the migration is in progress, who need to keep the migration running for prolonged periods of time (such as weeks or months at a time), who require true online replication to the Business Critical service tier, and for customers who require the most performant minimum downtime migration. |
The following table lists alternative migration tools:
| Technology | Description |
|---|---|
| Transactional replication | Replicate data from source SQL Server database tables to SQL Managed Instance by providing a publisher-subscriber type migration option while maintaining transactional consistency. |
| Bulk copy | The bulk copy program (bcp) tool copies data from an instance of SQL Server into a data file. Use the tool to export the data from your source and import the data file into the target SQL managed instance. For high-speed bulk copy operations to move data to Azure SQL Managed Instance, you can use the Smart Bulk Copy tool to maximize transfer speed by taking advantage of parallel copy tasks. |
| Import Export Wizard/BACPAC | BACPAC is a Windows file with a .bacpac extension that encapsulates a database's schema and data. You can use BACPAC to both export data from a SQL Server source and import the data back into Azure SQL Managed Instance. |
| Azure Data Factory | The Copy activity in Azure Data Factory migrates data from source SQL Server databases to SQL Managed Instance by using built-in connectors and an integration runtime. Data Factory supports a wide range of connectors to move data from SQL Server sources to SQL Managed Instance. |
Compare migration options
Compare migration options to choose the path that's appropriate to your business needs.
The following table compares the recommended migration options:
| Migration option | When to use | Considerations |
|---|---|---|
| Link feature for Azure SQL Managed Instance | - Minimum downtime required, especially for critical workloads. - Need to migrate to the Business Critical service tier. - Need to migrate multiple databases. - Need read-only access to the database on Azure SQL Managed Instance during the migration. - Need to reverse migrate out of Azure to SQL Server 2022. - Migrate individual line-of-business application databases, or multiple databases to the same or multiple SQL managed instances. - Need flexibility for the cut over time frame. Supported sources: - SQL Server (2016 to 2022) on-premises or Azure VM - Amazon EC2 - GCP Compute SQL Server VM |
- The migration entails establishing a network connection between SQL Server and SQL Managed Instance, and opening communication ports. - Uses Always On distributed availability group technology to replicate database near real-time, making an exact replica of the SQL Server database on SQL Managed Instance. - The database can be used for read-only access on SQL Managed Instance while the migration is in progress. - Provides the best performance during migration with the most minimum downtime. - Can cut over at any time, so migration duration is unlimited - Not impacted by system updates or failovers |
| Azure SQL Migration extension for Azure Data Studio | - Migrate single databases or at scale. - Can run in both online and offline modes. Supported sources: - SQL Server (2005 onward) on-premises, or on Azure Virtual Machines - SQL Server on Amazon EC2 - Amazon RDS for SQL Server - SQL Server on Google Compute Engine |
- Migrations at scale can be automated via PowerShell or Azure CLI. - Time to complete migration depends on database size and the number of objects in the database. - Azure Data Studio is required when you aren't using PowerShell or Azure CLI. |
| Log Replay Service | - Migrate individual line-of-business application databases. - Need more control over database migration. - Non-sensitive workloads that can afford downtime. - Can only use a public endpoint. - Need to migrate multiple databases. Supported sources: - SQL Server (2008 to 2019) on-premises or Azure VM - Amazon EC2 - Amazon RDS for SQL Server - GCP Compute SQL Server VM |
- The migration entails making full database backups on SQL Server and copying backup files to Azure Blob Storage. Log Replay Service is used to restore backup files from Azure Blob Storage to SQL Managed Instance. - Databases during the migration process are in restoring mode and can't be used for read or write workloads until the process is complete. - Uses a public endpoint, so special network configuration isn't necessary. - Can be interrupted by system updates or failovers. |
| Native backup and restore | - Migrate individual line-of-business application databases. - Quick and easy migration without a separate migration service or tool. Supported sources: - SQL Server (2005 to 2019) on-premises or Azure VM - Amazon EC2 - GCP Compute SQL Server VM |
- Database backup uses multiple threads to optimize data transfer to Azure Blob Storage, but partner bandwidth and database size can affect transfer rate. - Downtime should accommodate the time required to perform a full backup and restore (which is a size of data operation). |
The following table compares the alternative migration options:
| Method or technology | When to use | Considerations |
|---|---|---|
| Transactional replication | - Migrate by continuously publishing changes from source database tables to target SQL Managed Instance database tables. - Do full or partial database migrations of selected tables (subset of a database). Supported sources: - SQL Server (2012 to 2019) with some limitations - Amazon EC2 - GCP Compute SQL Server VM |
- Setup is relatively complex compared to other migration options. - Provides a continuous replication option to migrate data (without taking the databases offline). - Transactional replication has limitations to consider when you're setting up the publisher on the source SQL Server instance. See Limitations on publishing objects to learn more. - Capability to monitor replication activity is available. |
| Bulk copy | - Do full or partial data migrations. - Can accommodate downtime. Supported sources: - SQL Server (2005 to 2019) on-premises or Azure VM - Amazon EC2 - Amazon RDS for SQL Server - GCP Compute SQL Server VM |
- Requires downtime for exporting data from the source and importing into the target. - The file formats and data types used in the export or import need to be consistent with table schemas. |
| Import Export Wizard/BACPAC | - Migrate individual line-of-business application databases. - Suited for smaller databases. Doesn't require a separate migration service or tool. Supported sources: - SQL Server (2005 to 2019) on-premises or Azure VM - Amazon EC2 - Amazon RDS - GCP Compute SQL Server VM |
- Requires downtime because data needs to be exported at the source and imported at the destination. - The file formats and data types used in the export or import need to be consistent with table schemas to avoid truncation or data-type mismatch errors. - Time taken to export a database with a large number of objects can be significantly higher. |
| Azure Data Factory | - Migrate and/or transform data from source SQL Server databases. - Merging data from multiple sources of data to Azure SQL Managed Instance is typically for business intelligence (BI) workloads. - Requires creating data movement pipelines in Data Factory to move data from source to destination. - Cost is an important consideration and is based on factors like pipeline triggers, activity runs, and duration of data movement. |
Feature interoperability
There are more considerations when you're migrating workloads that rely on other SQL Server features.
SQL Server Integration Services
Migrate SQL Server Integration Services (SSIS) packages and projects in SSISDB to Azure SQL Managed Instance by using Azure Database Migration Service.
Only SSIS packages in SSISDB starting with SQL Server 2012 are supported for migration. Convert older SSIS packages before migration. See the project conversion tutorial to learn more.
SQL Server Reporting Services
You can migrate SQL Server Reporting Services (SSRS) reports to paginated reports in Power BI. Use the RDL Migration Tool to help prepare and migrate your reports. Microsoft developed this tool to help customers migrate Report Definition Language (RDL) reports from their SSRS servers to Power BI. It's available on GitHub, and it documents an end-to-end walkthrough of the migration scenario.
SQL Server Analysis Services
SQL Server Analysis Services tabular models from SQL Server 2012 and later can be migrated to Azure Analysis Services, which is a platform as a service (PaaS) deployment model for the Analysis Services tabular model in Azure. You can learn more about migrating on-premises models to Azure Analysis Services in this video tutorial.
Alternatively, you can consider migrating your on-premises Analysis Services tabular models to Power BI Premium by using the new XMLA read/write endpoints.
High availability
The SQL Server high-availability features Always On failover cluster instances and Always On availability groups become obsolete on the target SQL managed instance. High-availability architecture is already built into both General Purpose (standard availability model) and Business Critical (premium availability model) service tiers for SQL Managed Instance. The premium availability model also provides read scale-out that allows connecting into one of the secondary nodes for read-only purposes.
Beyond the high-availability architecture that's included in SQL Managed Instance, the failover groups feature allows you to manage the replication and failover of databases in a managed instance to another region.
SQL Agent jobs
Use the offline Azure Database Migration Service option to migrate SQL Agent jobs. Otherwise, script the jobs in Transact-SQL (T-SQL) by using SQL Server Management Studio and then manually re-create them on the target SQL managed instance.
Important
Currently, Azure Database Migration Service supports only jobs with T-SQL subsystem steps. Jobs with SSIS package steps have to be manually migrated.
Logins and groups
Move SQL logins from the SQL Server source to Azure SQL Managed Instance by using Database Migration Service in offline mode. Use the Select logins pane in the Migration Wizard to migrate logins to your target SQL managed instance.
By default, Azure Database Migration Service supports migrating only SQL logins. However, you can enable the migration of Windows logins by:
- Ensuring that the target SQL managed instance has read access to Microsoft Entra ID (formerly Azure Active Directory). A user who has the Global Administrator role can configure that access via the Azure portal.
- Configuring Azure Database Migration Service to enable Windows user or group login migrations. You set this up via the Azure portal, on the Configuration page. After you enable this setting, restart the service for the changes to take effect.
After you restart the service, Windows user or group logins appear in the list of logins available for migration. For any Windows user or group logins that you migrate, you're prompted to provide the associated domain name. Service user accounts (accounts with the domain name NT AUTHORITY) and virtual user accounts (accounts with the domain name NT SERVICE) aren't supported. To learn more, see Tutorial: Migrate Windows users and groups in a SQL Server instance to Azure SQL Managed Instance using T-SQL DDL syntax.
Alternatively, you can use the PowerShell utility specially designed by Microsoft data migration architects. The utility uses PowerShell to create a T-SQL script to re-create logins and select database users from the source to the target.
The PowerShell utility automatically maps Windows Server Active Directory accounts to Microsoft Entra accounts, and it can do a UPN lookup for each login against the source Active Directory instance. The utility scripts custom server and database roles, along with role membership and user permissions. Contained databases aren't yet supported, and only a subset of possible SQL Server permissions is scripted.
Encryption
When you're migrating databases protected by transparent data encryption to a managed instance by using the native restore option, migrate the corresponding certificate from the source SQL Server instance to the target SQL managed instance before database restore.
System databases
Restore of system databases isn't supported. To migrate instance-level objects (stored in the master and msdb databases), script them by using T-SQL and then re-create them on the target managed instance.
In-Memory OLTP (memory-optimized tables)
SQL Server provides an In-Memory OLTP capability. It allows usage of memory-optimized tables, memory-optimized table types, and natively compiled SQL modules to run workloads that have high-throughput and low-latency requirements for transactional processing.
Important
In-Memory OLTP is supported only in the Business Critical tier in Azure SQL Managed Instance. It's not supported in the General Purpose tier.
If you have memory-optimized tables or memory-optimized table types in your on-premises SQL Server instance and you want to migrate to Azure SQL Managed Instance, you should either:
Choose the Business Critical tier for your target SQL managed instance that supports In-Memory OLTP.
If you want to migrate to the General Purpose tier in Azure SQL Managed Instance, remove memory-optimized tables, memory-optimized table types, and natively compiled SQL modules that interact with memory-optimized objects before migrating your databases. You can use the following T-SQL query to identify all objects that need to be removed before migration to the General Purpose tier:
SELECT * FROM sys.tables WHERE is_memory_optimized=1 SELECT * FROM sys.table_types WHERE is_memory_optimized=1 SELECT * FROM sys.sql_modules WHERE uses_native_compilation=1
To learn more about in-memory technologies, see Optimize performance by using in-memory technologies in Azure SQL Database and Azure SQL Managed Instance.
Advanced features
Be sure to take advantage of the advanced cloud-based features in SQL Managed Instance. For example, you don't need to worry about managing backups because the service does it for you. You can restore to any point in time within the retention period. Additionally, you don't need to worry about setting up high availability, because high availability is built in.
To strengthen security, consider using Microsoft Entra authentication, auditing, threat detection, row-level security, and dynamic data masking.
In addition to advanced management and security features, SQL Managed Instance provides advanced tools that can help you monitor and tune your workload. Azure SQL Analytics allows you to monitor a large set of managed instances in a centralized way. Automatic tuning in managed instances continuously monitors performance of your SQL plan execution and automatically fixes the identified performance problems.
Some features are available only after the database compatibility level is changed to the latest compatibility level (150).
Migration assets
For more assistance, see the following resources that were developed for real-world migration projects.
| Asset | Description |
|---|---|
| Data workload assessment model and tool | This tool provides suggested "best fit" target platforms, cloud readiness, and an application/database remediation level for a workload. It offers simple, one-click calculation and report generation that helps to accelerate large estate assessments by providing an automated and uniform decision process for target platforms. |
| Utility to move on-premises SQL Server logins to Azure SQL Managed Instance | A PowerShell script can create a T-SQL command script to re-create logins and select database users from on-premises SQL Server to Azure SQL Managed Instance. The tool allows automatic mapping of Windows Server Active Directory accounts to Microsoft Entra accounts, along with optionally migrating SQL Server native logins. |
| Perfmon data collection automation by using Logman | You can use the Logman tool to collect Perfmon data (to help you understand baseline performance) and get migration target recommendations. This tool uses logman.exe to create the command that will create, start, stop, and delete performance counters set on a remote SQL Server instance. |
The Data SQL Engineering team developed these resources. This team's core charter is to unblock and accelerate complex modernization for data platform migration projects to Microsoft's Azure data platform.
Related content
- Migration guide: SQL Server to Azure SQL Managed Instance
- Services and tools available for data migration scenarios
- Service tiers in Azure SQL Managed Instance
- T-SQL differences between SQL Server & Azure SQL Managed Instance
- Azure Total Cost of Ownership Calculator
- Cloud Adoption Framework for Azure
- Best practices for costing and sizing workloads migrated to Azure
- Data Access Migration Toolkit (Preview)
- Overview of Database Experimentation Assistant