Skip to content

Commit cd1fb93

Browse files
Merge pull request #217508 from kavitham10/addMoreContentToTroubleshootingGuide
Add more content to troubleshooting guide
2 parents 86d24bd + e4cb409 commit cd1fb93

File tree

1 file changed

+29
-1
lines changed

1 file changed

+29
-1
lines changed

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

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,10 +81,35 @@ Known issues and limitations associated with the Azure SQL Migration extension f
8181

8282
- **Recommendation**: See [Configure Azure Storage firewalls and virtual networks](/azure/storage/common/storage-network-security) for more information on Azure Storage firewall setup.
8383

84+
- **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.`
85+
86+
- **Cause**: Backups of multiple databases are in the same container folder.
87+
88+
- **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.
89+
90+
8491
> [!NOTE]
8592
> For more information on general troubleshooting steps for Azure SQL Managed Instance errors, see [Known issues with Azure SQL Managed Instance](/azure/azure-sql/managed-instance/doc-changes-updates-known-issues)
8693
8794
### Error code: 2012 - TestConnectionFailed
95+
- **Message**: `Failed to test connections using provided Integration Runtime. Error details: 'Remote name could not be resolved.'`
96+
97+
- **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.
98+
99+
- **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.
100+
101+
- **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`
102+
103+
- **Cause**: The Self-Hosted Integration Runtime can't connect to the network file share where the database backups are placed.
104+
105+
- **Recommendation**: Make sure your network file share name is entered correctly.
106+
107+
- **Message**: `Failed to test connections using provided Integration Runtime. The file name does not conform to the naming rules by the data store. Illegal characters in path.`
108+
109+
- **Cause**: The Self-Hosted Integration Runtime can't connect to the network file share where the database backups are placed.
110+
111+
- **Recommendation**: Make sure your network file share name is entered correctly.
112+
88113
- **Message**: `Failed to test connections using provided Integration Runtime.`
89114

90115
- **Cause**: Connection to the Self-Hosted Integration Runtime has failed.
@@ -127,7 +152,7 @@ Known issues and limitations associated with the Azure SQL Migration extension f
127152
### Error code: 2039 - MigrationRetryNotAllowed
128153
- **Message**: `Migration isn't in a retriable state. Migration must be in state WaitForRetry. Current state: <State>, Target server: <Target Server>, Target database: <Target database>.`
129154

130-
**Cause**: A retry request was received when the migration wasn't in a state allowing retrying.
155+
- **Cause**: A retry request was received when the migration wasn't in a state allowing retrying.
131156

132157
- **Recommendation**: No action required migration is ongoing or completed.
133158

@@ -188,6 +213,9 @@ The Azure SQL Database offline migration (Preview) utilizes Azure Data Factory (
188213
- 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.
189214
- Tables with large blob columns may fail to migrate due to timeout.
190215
- Database names with SQL Server reserved words aren't valid.
216+
- Database names with double-byte character set (DBCS) are currently not supported.
217+
- Table names that include semicolons are currently not supported.
218+
- Computed columns do not get migrated.
191219

192220
## Azure SQL Managed Instance and SQL Server on Azure Virtual Machine known issues and limitations
193221
- 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.

0 commit comments

Comments
 (0)