Skip to content

Commit 40d4e68

Browse files
authored
DM: Update MariaDB config hints (#22789)
1 parent fadf513 commit 40d4e68

2 files changed

Lines changed: 11 additions & 1 deletion

File tree

dm/dm-precheck.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,16 @@ For the incremental data migration mode (`task-mode: incremental`), in addition
138138
- Check whether `binlog_transaction_compression=OFF` is configured (DM does not support transaction compression).
139139
- If `binlog_do_db` or `binlog_ignore_db` is configured, check whether the database tables to be migrated meet the conditions of `binlog_do_db` and `binlog_ignore_db`.
140140

141+
* (Mandatory) MariaDB binlog configuration
142+
143+
- Check whether binlog is enabled (required by DM).
144+
- Check whether `binlog_legacy_event_pos` is set to `ON`.
145+
- Check whether `binlog_format=ROW` is configured (DM only supports the migration of binlog in the ROW format).
146+
- Check whether `binlog_row_image=FULL` is configured (DM only supports `binlog_row_image=FULL`).
147+
- If `binlog_do_db` or `binlog_ignore_db` is configured, check whether the database tables to be migrated meet the conditions of `binlog_do_db` and `binlog_ignore_db`.
148+
- Check whether `binlog_annotate_row_events` is set to `OFF`.
149+
- Check whether `log_bin_compress` is set to `OFF`.
150+
141151
* (Mandatory) Check if the upstream database is in an [Online-DDL](/dm/feature-online-ddl.md) process (in which the `ghost` table is created but the `rename` phase is not executed yet). If the upstream is in the online-DDL process, the precheck returns an error. In this case, wait until the DDL to complete and retry.
142152

143153
### Check items for full and incremental data migration

migrate-from-mariadb.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -294,7 +294,7 @@ To use DM, you need to deploy a set of DM services either with a [TiUP cluster](
294294

295295
### Step 1. Prepare
296296

297-
Make sure that binlogs are enabled on MariaDB and that the `binlog_format` is set to `ROW`. It is also recommended to set `binlog_annotate_row_events=OFF` and `log_bin_compress=OFF`.
297+
Enable binlog on MariaDB and set `binlog_format=ROW`, `binlog_row_image=FULL`, and `binlog_legacy_event_pos=ON`. Also set `binlog_annotate_row_events=OFF` and `log_bin_compress=OFF`.
298298

299299
You also need an account with the `SUPER` permission or with the `BINLOG MONITOR` and `REPLICATION MASTER ADMIN` permissions. This account also needs read permission for the schemas you are going to migrate.
300300

0 commit comments

Comments
 (0)