Skip to content

Commit 3abeabe

Browse files
authored
Merge pull request #222054 from croblesm/crobles-1220-misc-updates
Updating video in main page, adding more known issues
2 parents 8f338ac + e30d07c commit 3abeabe

File tree

2 files changed

+50
-27
lines changed

2 files changed

+50
-27
lines changed

articles/dms/known-issues-azure-sql-migration-azure-data-studio.md

Lines changed: 47 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
3434

3535
- **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.
3636

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).
3838

3939

4040
- **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
4848

4949
- **Cause**: The Azure SQL Managed Instance has reached its resource limits.
5050

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).
5252

5353

5454
- **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
7676

7777
- **Cause**: You've specified a logical file name that isn't in the database backup.
7878

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).
8080

8181

8282
- **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.'`
8383

8484
- **Cause**: Azure Storage firewall isn't configured to allow access to Azure SQL target.
8585

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).
8787

8888
- **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.`
8989

9090
- **Cause**: Backups of multiple databases are in the same container folder.
9191

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).
9393

9494

9595
> [!NOTE]
@@ -98,9 +98,9 @@ Known issues and limitations associated with the Azure SQL Migration extension f
9898
### Error code: 2012 - TestConnectionFailed
9999
- **Message**: `Failed to test connections using provided Integration Runtime. Error details: 'Remote name could not be resolved.'`
100100

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.
102102

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).
104104

105105
- **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`
106106

@@ -164,7 +164,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
164164
### Error code: 2040 - MigrationTimeoutWaitingForRetry
165165
- **Message**: `Migration retry timeout limit of 8 hours reached. Target server: <Target Server>, Target database: <Target Database>.`
166166

167-
- **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.
168168

169169
- **Recommendation**: No action is required; the migration was canceled.
170170

@@ -174,7 +174,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
174174

175175
- **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.
176176

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.
178178

179179
```
180180
SELECT [ROLLBACK] FROM [dbo].[__migration_status]
@@ -190,7 +190,7 @@ WHERE STEP in (5,7,8) ORDER BY STEP DESC;
190190

191191
- **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.
192192

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.
194194

195195
```
196196
SELECT [ROLLBACK] FROM [dbo].[__migration_status]
@@ -203,28 +203,46 @@ WHERE STEP in (3,4,6);
203203

204204
- **Cause**: The request failed due to an underlying issue such as network connectivity, a DNS failure, a server certificate validation, or a timeout.
205205

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).
207207

208208

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+
209212
## Azure SQL Database Migration limitations
210213

211214
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).
213216
- 100,000 table per database limit.
214217
- 10,000 concurrent database migrations per service.
215218
- Migration speed heavily depends on the target Azure SQL Database SKU and the self-hosted Integration Runtime host.
216219
- 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 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.
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.
218221
- 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.
228246
- Configuring high availability and disaster recovery on your target to match source topology isn't supported by DMS.
229247
- The following server objects aren't supported:
230248
- Logins
@@ -233,9 +251,14 @@ The Azure SQL Database offline migration (Preview) utilizes Azure Data Factory (
233251
- SSIS packages
234252
- Server roles
235253
- 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+
238255
- 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.
239262

240263
## Next steps
241264

articles/dms/migration-using-azure-data-studio.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.custom: references_regions
1515

1616
# Migrate databases by using the Azure SQL Migration extension for Azure Data Studio
1717

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.
1919

2020
The Azure SQL Migration extension for Azure Data Studio offers these key benefits:
2121

@@ -45,11 +45,11 @@ SQL Server to Azure SQL Database (preview)| [Offline](./tutorial-sql-server-azur
4545
> [!IMPORTANT]
4646
> 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.
4747
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:
4949

5050
<br />
5151

52-
> [!VIDEO https://learn-video.azurefd.net/vod/player?show=data-exposed&ep=assess-get-recommendations-migrate-sql-server-to-azure-using-azure-data-studio]
52+
> [!VIDEO https://learn-video.azurefd.net/vod/player?show=data-exposed&ep=how-to-migrate-sql-server-to-azure-sql-database-offline-using-azure-data-studio-data-exposed]
5353
5454
## Architecture of the Azure SQL Migration extension for Azure Data Studio
5555

0 commit comments

Comments
 (0)