You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/dms/known-issues-azure-sql-migration-azure-data-studio.md
+47-24Lines changed: 47 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
34
34
35
35
-**Cause**: The source SQL Server instance certificate from a database protected by Transparent Data Encryption (TDE) hasn't been migrated to the target Azure SQL Managed Instance or SQL Server on Azure Virtual Machine before migrating data.
36
36
37
-
-**Recommendation**: Migrate the TDE certificate to the target instance and retry the process. See [Migrate a certificate of a TDE-protected database to Azure SQL Managed Instance](/azure/azure-sql/managed-instance/tde-certificate-migrate) and [Move a TDE Protected Database to Another SQL Server](/sql/relational-databases/security/encryption/move-a-tde-protected-database-to-another-sql-server) for more information.
37
+
-**Recommendation**: Migrate the TDE certificate to the target instance and retry the process. For more information about this topic, see [Migrate a certificate of a TDE-protected database to Azure SQL Managed Instance](/azure/azure-sql/managed-instance/tde-certificate-migrate) and [Move a TDE Protected Database to Another SQL Server](/sql/relational-databases/security/encryption/move-a-tde-protected-database-to-another-sql-server).
38
38
39
39
40
40
-**Message**: `Migration for Database <DatabaseName> failed with error 'Non retriable error occurred while restoring backup with index 1 - 3169 The database was backed up on a server running version %ls. That version is incompatible with this server, which is running version %ls. Either restore the database on a server that supports the backup, or use a backup that is compatible with this server.`
@@ -48,7 +48,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
48
48
49
49
-**Cause**: The Azure SQL Managed Instance has reached its resource limits.
50
50
51
-
-**Recommendation**: See [Overview of Azure SQL Managed Instance resource limits](/azure/azure-sql/managed-instance/resource-limits) for more information.
51
+
-**Recommendation**: For more information about this topic, see [Overview of Azure SQL Managed Instance resource limits](/azure/azure-sql/managed-instance/resource-limits).
52
52
53
53
54
54
-**Message**: `Migration for Database <DatabaseName> failed with error 'Non retriable error occurred while restoring backup with index 1 - 3634 The operating system returned the error '1450(Insufficient system resources exist to complete the requested service.)`
@@ -76,20 +76,20 @@ Known issues and limitations associated with the Azure SQL Migration extension f
76
76
77
77
-**Cause**: You've specified a logical file name that isn't in the database backup.
78
78
79
-
-**Recommendation**: Run RESTORE FILELISTONLY to check the logical file names in your backup. See [RESTORE Statements - FILELISTONLY (Transact-SQL)](/sql/t-sql/statements/restore-statements-filelistonly-transact-sql) for more information on RESTORE FILELISTONLY.
79
+
-**Recommendation**: Run RESTORE FILELISTONLY to check the logical file names in your backup. For more information about RESTORE FILELISTONLY, see [RESTORE Statements - FILELISTONLY (Transact-SQL)](/sql/t-sql/statements/restore-statements-filelistonly-transact-sql).
80
80
81
81
82
82
-**Message**: `Migration for Database <Database Name> failed with error 'Azure SQL target resource failed to connect to storage account. Make sure the target SQL VNet is allowed under the Azure Storage firewall rules.'`
83
83
84
84
-**Cause**: Azure Storage firewall isn't configured to allow access to Azure SQL target.
85
85
86
-
-**Recommendation**: See [Configure Azure Storage firewalls and virtual networks](../storage/common/storage-network-security.md) for more information on Azure Storage firewall setup.
86
+
-**Recommendation**: For more information about Azure Storage firewall setup, see [Configure Azure Storage firewalls and virtual networks](../storage/common/storage-network-security.md).
87
87
88
88
-**Message**: `Migration for Database <Database Name> failed with error 'There are backups from multiple databases in the container folder. Please make sure the container folder has backups from a single database.`
89
89
90
90
-**Cause**: Backups of multiple databases are in the same container folder.
91
91
92
-
-**Recommendation**: If migrating multiple databases to **Azure SQL Managed Instance** using the same Azure Blob Storage container, you must place backup files for different databases in separate folders inside the container. See [Migrate databases from SQL Server to SQL Managed Instance by using Log Replay Service (Preview)](/azure/azure-sql/managed-instance/log-replay-service-migrate#limitations) for more information.
92
+
-**Recommendation**: If migrating multiple databases to **Azure SQL Managed Instance** using the same Azure Blob Storage container, you must place backup files for different databases in separate folders inside the container. For more information about this topic, see [Migrate databases from SQL Server to SQL Managed Instance by using Log Replay Service (Preview)](/azure/azure-sql/managed-instance/log-replay-service-migrate#limitations).
93
93
94
94
95
95
> [!NOTE]
@@ -98,9 +98,9 @@ Known issues and limitations associated with the Azure SQL Migration extension f
98
98
### Error code: 2012 - TestConnectionFailed
99
99
-**Message**: `Failed to test connections using provided Integration Runtime. Error details: 'Remote name could not be resolved.'`
100
100
101
-
-**Cause**: The Self-Hosted Integration Runtime can't connect to the service back end. This issue is usually caused by network settings in the firewall.
101
+
-**Cause**: The Self-Hosted Integration Runtime can't connect to the service back end. This issue is caused by network settings in the firewall.
102
102
103
-
-**Recommendation**: There's a Domain Name System (DNS) issue. Contact your network team to fix the issue. See [Troubleshoot Self-Hosted Integration Runtime](../data-factory/self-hosted-integration-runtime-troubleshoot-guide.md) for more information.
103
+
-**Recommendation**: There's a Domain Name System (DNS) issue. Contact your network team to fix the issue. For more information about this topic, see [Troubleshoot Self-Hosted Integration Runtime](../data-factory/self-hosted-integration-runtime-troubleshoot-guide.md).
104
104
105
105
-**Message**: `Failed to test connections using provided Integration Runtime. 'Cannot connect to <File share>. Detail Message: The system could not find the environment option that was entered`
106
106
@@ -164,7 +164,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
-**Cause**: Migration was idle in a failed, but retriable state for 8 hours and was automatically canceled.
167
+
-**Cause**: Migration was idle in a failed, but retrievable state for 8 hours and was automatically canceled.
168
168
169
169
-**Recommendation**: No action is required; the migration was canceled.
170
170
@@ -174,7 +174,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
174
174
175
175
-**Cause**: Cancel request was received, and the data copy was completed successfully, but the target database schema hasn't been returned to its original state.
176
176
177
-
-**Recommendation**: If desired, the target database can be returned to its original state by running the first query below and all of the returned queries, then running the second query and doing the same.
177
+
-**Recommendation**: If desired, the target database can be returned to its original state by running the first query and all of the returned queries, then running the second query and doing the same.
178
178
179
179
```
180
180
SELECT [ROLLBACK] FROM [dbo].[__migration_status]
@@ -190,7 +190,7 @@ WHERE STEP in (5,7,8) ORDER BY STEP DESC;
190
190
191
191
-**Cause**: Cancel request was received and the steps to prepare the target database for copy were completed successfully. The target database schema hasn't been returned to its original state.
192
192
193
-
-**Recommendation**: If desired, target database can be returned to its original state by running the query below and all of the returned queries.
193
+
-**Recommendation**: If desired, target database can be returned to its original state by running the following query and all of the returned queries.
194
194
195
195
```
196
196
SELECT [ROLLBACK] FROM [dbo].[__migration_status]
@@ -203,28 +203,46 @@ WHERE STEP in (3,4,6);
203
203
204
204
-**Cause**: The request failed due to an underlying issue such as network connectivity, a DNS failure, a server certificate validation, or a timeout.
205
205
206
-
-**Recommendation**: See [Troubleshoot Azure Data Factory and Synapse pipelines](../data-factory/data-factory-troubleshoot-guide.md#error-code-2108) for troubleshooting steps.
206
+
-**Recommendation**: For more troubleshooting steps, see [Troubleshoot Azure Data Factory and Synapse pipelines](../data-factory/data-factory-troubleshoot-guide.md#error-code-2108).
207
207
208
208
209
+
## Database Migration Service issues
210
+
Migrations that were completed before early December 2022 may be missing migration details. This action doesn't have a negative effect on new or ongoing migrations.
211
+
209
212
## Azure SQL Database Migration limitations
210
213
211
214
The Azure SQL Database offline migration (Preview) utilizes Azure Data Factory (ADF) pipelines for data movement and thus abides by ADF limitations. A corresponding ADF is created when a database migration service is also created. Thus factory limits apply per service.
212
-
215
+
The machine where the SHIR is installed acts as the compute for migration. Make sure this machine can handle the cpu and memory load of the data copy. To learn more, review [SHIR recommendations](/azure/data-factory/create-self-hosted-integration-runtime).
213
216
- 100,000 table per database limit.
214
217
- 10,000 concurrent database migrations per service.
215
218
- Migration speed heavily depends on the target Azure SQL Database SKU and the self-hosted Integration Runtime host.
216
219
- Azure SQL Database migration scales poorly with table numbers due to ADF overhead in starting activities. If a database has thousands of tables, there will be a couple of seconds of startup time for each, even if they're composed of one row with 1 bit of data.
217
-
- Azure SQL Database table names with doublebyte characters currently aren't supported for migration. Mitigation is to rename tables before migration; they can be changed back to their original names after successful migration.
220
+
- Azure SQL Database table names with double-byte characters currently aren't supported for migration. Mitigation is to rename tables before migration; they can be changed back to their original names after successful migration.
218
221
- Tables with large blob columns may fail to migrate due to timeout.
219
-
- Database names with SQL Server reserved words aren't valid.
220
-
- Database names with double-byte character set (DBCS) are currently not supported.
221
-
- Table names that include semicolons are currently not supported.
222
-
- Computed columns do not get migrated.
223
-
224
-
## Azure SQL Managed Instance and SQL Server on Azure Virtual Machine known issues and limitations
225
-
- If migrating multiple databases to **Azure SQL Managed Instance** using the same Azure Blob Storage container, you must place backup files for different databases in separate folders inside the container.
226
-
- If migrating a single database to **Azure SQL Managed Instance**, the database backups must be placed in a flat-file structure inside a database folder, and the folders can't be nested, as it's not supported.
227
-
- Overwriting existing databases using DMS in your target Azure SQL Managed Instance or SQL Server on Azure Virtual Machine isn't supported.
222
+
- Database names with SQL Server reserved are currently not supported.
223
+
- Database names that include semicolons are currently not supported.
224
+
- Computed columns don't get migrated.
225
+
226
+
## Azure SQL Managed Instance known issues and limitations
227
+
228
+
- If migrating a single database, the database backups must be placed in a flat-file structure inside a database folder (including the container root folder), and the folders can't be nested, as it's not supported.
229
+
- If migrating multiple databases using the same Azure Blob Storage container, you must place backup files for different databases in separate folders inside the container.
230
+
- Overwriting existing databases using DMS in your target Azure SQL Managed Instance isn't supported.
231
+
- Configuring high availability and disaster recovery on your target to match source topology isn't supported by DMS.
232
+
- The following server objects aren't supported:
233
+
- Logins
234
+
- SQL Server Agent jobs
235
+
- Credentials
236
+
- SSIS packages
237
+
- Server roles
238
+
- Server audit
239
+
- You can't use an existing self-hosted integration runtime created from Azure Data Factory for database migrations with DMS. Initially, the self-hosted integration runtime should be created using the Azure SQL migration extension in Azure Data Studio and can be reused for further database migrations.
240
+
241
+
## SQL Server on Azure Virtual Machine known issues and limitations
242
+
243
+
- If migrating a single database, the database backups must be placed in a flat-file structure inside a database folder (including the container root folder), and the folders can't be nested, as it's not supported.
244
+
- If migrating multiple databases using the same Azure Blob Storage container, you must place backup files for different databases in separate folders inside the container.
245
+
- Overwriting existing databases using DMS in your target SQL Server on Azure Virtual Machine isn't supported.
228
246
- Configuring high availability and disaster recovery on your target to match source topology isn't supported by DMS.
229
247
- The following server objects aren't supported:
230
248
- Logins
@@ -233,9 +251,14 @@ The Azure SQL Database offline migration (Preview) utilizes Azure Data Factory (
233
251
- SSIS packages
234
252
- Server roles
235
253
- Server audit
236
-
- SQL Server 2008 and below as target versions aren't supported when migrating to SQL Server on Azure Virtual Machines.
237
-
- If you're using SQL Server 2012 or SQL Server 2014, you need to store your source database backup files on an Azure Storage Blob Container instead of using the network share option. Store the backup files as page blobs since block blobs are only supported in SQL 2016 and after.
254
+
238
255
- You can't use an existing self-hosted integration runtime created from Azure Data Factory for database migrations with DMS. Initially, the self-hosted integration runtime should be created using the Azure SQL migration extension in Azure Data Studio and can be reused for further database migrations.
256
+
- VM with SQL Server 2008 and below as target versions aren't supported when migrating to SQL Server on Azure Virtual Machines.
257
+
- If you're using VM with SQL Server 2012 or SQL Server 2014, you need to store your source database backup files on an Azure Storage Blob Container instead of using the network share option. Store the backup files as page blobs since block blobs are only supported in SQL 2016 and after.
258
+
- You must make sure the [SQL IaaS Agent Extension](/azure/azure-sql/virtual-machines/windows/sql-server-iaas-agent-extension-automate-management) in the target Azure Virtual Machine is in **Full** mode instead of **Lightweight** mode.
259
+
-[SQL IaaS Agent Extension](/azure/azure-sql/virtual-machines/windows/sql-server-iaas-agent-extension-automate-management)only supports management of **Default Server Server Instance** or **Single Named Instance**,
260
+
- There's a temporary limit of 80 databases per target Azure Virtual Machine. A workaround to break the limit (reset the counter) is to **Uninstall** and **Reinstall**[SQL IaaS Agent Extension](/azure/azure-sql/virtual-machines/windows/sql-server-iaas-agent-extension-automate-management) in the target Azure Virtual Machine.
261
+
- Apart from configuring the Networking/Firewall of your Storage Account to allow your VM to access backup files, you also need to configure the Networking/Firewall of your VM to allow outbound connection to your storage account.
Copy file name to clipboardExpand all lines: articles/dms/migration-using-azure-data-studio.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ ms.custom: references_regions
15
15
16
16
# Migrate databases by using the Azure SQL Migration extension for Azure Data Studio
17
17
18
-
Learn how to use the unified experience in [Azure SQL Migration extension for Azure Data Studio](/sql/azure-data-studio/extensions/azure-sql-migration-extension)to assess your database requirements, get right-sized SKU recommendations for Azure resources, and migrate your SQL Server database to Azure.
18
+
Learn how to use the unified experience in [Azure SQL Migration extension for Azure Data Studio](/sql/azure-data-studio/extensions/azure-sql-migration-extension). Helps you to assess your database requirements, get the right-sized SKU recommendations for Azure resources, and migrate your SQL Server database to Azure.
19
19
20
20
The Azure SQL Migration extension for Azure Data Studio offers these key benefits:
21
21
@@ -45,11 +45,11 @@ SQL Server to Azure SQL Database (preview)| [Offline](./tutorial-sql-server-azur
45
45
> [!IMPORTANT]
46
46
> If your target is Azure SQL Database, make sure you deploy the database schema before you begin the migration. You can use tools like the [SQL Server dacpac extension](/sql/azure-data-studio/extensions/sql-server-dacpac-extension) or the [SQL Database Projects extension](/sql/azure-data-studio/extensions/sql-database-project-extension) for Azure Data Studio.
47
47
48
-
The following 16-minute video explains recent updates and features added to the Azure SQL Migration extension for Azure Data Studio, including the new workflow for SQL Server database assessments and SKU recommendations:
48
+
The following video explains recent updates and features added to the Azure SQL Migration extension for Azure Data Studio:
0 commit comments