Skip to content

Commit bfb49d5

Browse files
committed
Edits to known issues and additional errors/issues
1 parent 43effca commit bfb49d5

File tree

1 file changed

+74
-4
lines changed

1 file changed

+74
-4
lines changed

articles/dms/known-issues-azure-mysql-fs-online.md

Lines changed: 74 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Known issues associated with migrations to Azure Database for MySQL are describe
1616

1717
## Incompatible SQL Mode
1818

19-
One or more incompatible SQL modes can cause a number of different errors. Below is an example error along with server modes that should be looked at if this error occurs.``
19+
One or more incompatible SQL modes can cause a number of different errors. Below is an example error along with server modes that should be looked at if this error occurs.
2020

2121
- **Error**: An error occurred while preparing the table '{table}' in database '{database}' on server '{server}' for migration during activity '{activity}'. As a result, this table will not be migrated.
2222

@@ -30,9 +30,7 @@ One or more incompatible SQL modes can cause a number of different errors. Below
3030

3131
## Binlog Retention Issues
3232

33-
- **Error**:
34-
- Binary log is not open.
35-
- Could not find first log file name in binary log index file.
33+
- **Error**: Fatal error reading binlog.This error may indicate that the binlog file name and/or the initial position were specified incorrectly.
3634

3735
**Limitation**: This error occurs if binlog retention period is too short.
3836

@@ -54,6 +52,78 @@ One or more incompatible SQL modes can cause a number of different errors. Below
5452

5553
**Workaround**: Please reach out to support by [creating a support request](https://ms.portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview?DMC=troubleshoot) and we can provide custom scripts to access our REST APIs directly.
5654

55+
## Duplicate Key Entry Issue
56+
57+
- **Error**: The error is often a symptom of timeouts, network issues or target scaling.
58+
59+
**Potential error message**: A batch could not be written to the table '{table}' due to a SQL error raised by the target server. For context, the batch contained a subset of rows returned by the following source query.
60+
61+
**Limitation**: This error can be caused by timeout or broken connection to the target, resulting in duplicate primary keys. It may also be related to multiple migrations to the target running at the same time, or the user having test workloads running on the target while the migration is running. Additionally, the target may require primary keys to be unique, even though they are not required to be so on the source.
62+
63+
**Workaround**: To resolve this issue, ensure that there are no duplicate migrations running and that the source primary keys are unique. If error persists, please reach out to support by [creating a support request](https://ms.portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview?DMC=troubleshoot) and we can provide custom scripts to access our REST APIs directly.
64+
65+
## Replicated Operation Had Mismatched Rows Error
66+
67+
- **Error**: Online Migration Fails to Replicate Expected Number of Changes.
68+
69+
**Potential error message**: An error occurred applying records to the target server which were read from the source server's binary log. The changes started at binary log '{mysql-bin.log}' and position '{position}' and ended at binary log '{mysql-bin.log}' and position '{position}'. All records on the source server prior to position '{position}' in binary log '{mysql-bin.log}' have been committed to the target.
70+
71+
**Limitation**: On the source, there were insert and delete statements into a table, and the deletes were by an apparent unique index.
72+
73+
**Workaround**: It is recommended to migrate the table manually.
74+
75+
## Table Data Truncated Error
76+
77+
- **Error**: Enum column has a null value in one or more rows and the target SQL mode is set to strict.
78+
79+
**Potential error message**: A batch could not be written to the table '{table}' due to a data truncation error. Please ensure that the data is not too large for the data type of the MySQL table column. If the column type is an enum, make sure SQL Mode is not set as TRADITIONAL, STRICT_TRANS_TABLES or STRICT_ALL_TABLES and is the same on source and target.
80+
81+
**Limitation**: The error occurs when historical data was written to the source server when they had certain setting, but when it is changed, data cannot move.
82+
83+
**Workaround**: To resolve the issue, it is recommended to change the target SQL mode to non-strict or change all null values to be valid values.
84+
85+
## Creating Object Failure
86+
87+
- **Error**: An error occurred after view validation failed.
88+
89+
**Limitation**: The error occurs when trying to migrate a view and the table that the view is supposed to be referencing cannot be found.
90+
91+
**Workaround**: It is recommended to migrate views manually.
92+
93+
## Unable To Find Table
94+
95+
- **Error**: An error occurred as referencing table cannot be found.
96+
97+
**Potential error message**: The pipeline was unable to create the schema of object '{object}' for activity '{activity}' using strategy MySqlSchemaMigrationViewUsingTableStrategy because of a query execution.
98+
99+
**Limitation**: The error can occur when the view is referring to a table that has been deleted or renamed, or when the view was created with incorrect or incomplete information.
100+
101+
**Workaround**: It is recommended to migrate views manually.
102+
103+
## All Pooled Connections Broken
104+
105+
- **Error**: All connections on the source server were broken.
106+
107+
**Limitation**: The error occurs when all the connections that are acquired at the start of initial load are lost due to server restart, network issues, heavy traffic on the source server or other transient problems. This error is not recoverable.
108+
109+
**Workaround**: The migration must be restarted, and it is recommended to increase the performance of the source server. Another issue is scripts that kill long running connections, prevents these scripts from working.
110+
111+
## Consistent Snapshot Broken
112+
113+
**Limitation**: The error occurs when the customer performs DDL during the initial load of the migration instance.
114+
115+
**Workaround**: To resolve this issue, it is recommended to refrain from making DDL changes during the Initial Load.
116+
117+
## Foreign Key Constraint
118+
119+
- **Error**: The error occurs when there is a change in the referenced foreign key type from the table.
120+
121+
**Potential error message**: Referencing column '{pk column 1}' and referenced column '{fk column 1}' in foreign key constraint '{key}' are incompatible.
122+
123+
**Limitation**: The error can cause schema migration of a table to fail, as the PK column in table 1 may not be compatible with the FK column in table do.
124+
125+
**Workaround**: To resolve this issue, it is recommended to drop the foreign key and re-create it after the migration process is completed.
126+
57127
## Next steps
58128

59129
* View the tutorial [Migrate Azure Database for MySQL - Single Server to Flexible Server online using DMS via the Azure portal](tutorial-mysql-azure-single-to-flex-online-portal.md).

0 commit comments

Comments
 (0)