Skip to content

Commit 2b373be

Browse files
authored
DM: Update MariaDB config hints (#22789) (#22862)
1 parent 744c887 commit 2b373be

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
@@ -134,6 +134,16 @@ For the incremental data migration mode (`task-mode: incremental`), in addition
134134
- Check whether `binlog_transaction_compression=OFF` is configured (DM does not support transaction compression).
135135
- 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`.
136136

137+
* (Mandatory) MariaDB binlog configuration
138+
139+
- Check whether binlog is enabled (required by DM).
140+
- Check whether `binlog_legacy_event_pos` is set to `ON`.
141+
- Check whether `binlog_format=ROW` is configured (DM only supports the migration of binlog in the ROW format).
142+
- Check whether `binlog_row_image=FULL` is configured (DM only supports `binlog_row_image=FULL`).
143+
- 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`.
144+
- Check whether `binlog_annotate_row_events` is set to `OFF`.
145+
- Check whether `log_bin_compress` is set to `OFF`.
146+
137147
* (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.
138148

139149
### 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
@@ -292,7 +292,7 @@ To use DM, you need to deploy a set of DM services either with a [TiUP cluster](
292292

293293
### Step 1. Prepare
294294

295-
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`.
295+
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`.
296296

297297
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.
298298

0 commit comments

Comments
 (0)