You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/requirements-and-limitations.md
+9Lines changed: 9 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,20 +17,29 @@ The `SUPER` privilege is required for `STOP SLAVE`, `START SLAVE` operations. Th
17
17
18
18
- Switching your `binlog_format` to `ROW`, in the case where it is _not_`ROW` and you explicitly specified `--switch-to-rbr`
19
19
- If your replication is already in RBR (`binlog_format=ROW`) you can specify `--assume-rbr` to avoid the `STOP SLAVE/START SLAVE` operations, hence no need for `SUPER`.
20
+
20
21
- Running `--test-on-replica`: before the cut-over phase, `gh-ost` stops replication so that you can compare the two tables and satisfy that the migration is sound.
21
22
22
23
### Limitations
23
24
24
25
- Foreign keys not supported. They may be supported in the future, to some extent.
26
+
25
27
- Triggers are not supported. They may be supported in the future.
28
+
26
29
- MySQL 5.7 generated columns are not supported. They may be supported in the future.
30
+
27
31
- The two _before_ & _after_ tables must share some `UNIQUE KEY`. Such key would be used by `gh-ost` to iterate the table.
28
32
- As an example, if your table has a single `UNIQUE KEY` and no `PRIMARY KEY`, and you wish to replace it with a `PRIMARY KEY`, you will need two migrations: one to add the `PRIMARY KEY` (this migration will use the existing `UNIQUE KEY`), another to drop the now redundant `UNIQUE KEY` (this migration will use the `PRIMARY KEY`).
33
+
29
34
- The chosen migration key must not include columns with `NULL` values.
30
35
-`gh-ost` will do its best to pick a migration key with non-nullable columns. It will by default refuse a migration where the only possible `UNIQUE KEY` includes nullable-columns. You may override this refusal via `--allow-nullable-unique-key` but **you must** be sure there are no actual `NULL` values in those columns. Such `NULL` values would cause a data integrity problem and potentially a corrupted migration.
36
+
31
37
- It is not allowed to migrate a table where another table exists with same name and different upper/lower case.
32
38
- For example, you may not migrate `MyTable` if another table called `MYtable` exists in the same schema.
39
+
33
40
- Amazon RDS and Google Cloud SQL are currently not supported
34
41
- We began working towards removing this limitation. See tracking issue: https://github.com/github/gh-ost/issues/163
42
+
35
43
- Multisource is not supported when migrating via replica. It _should_ work (but never tested) when connecting directly to master (`--allow-on-master`)
44
+
36
45
- Master-master setup is only supported in active-passive setup. Active-active (where table is being written to on both masters concurrently) is unsupported. It may be supported in the future.
0 commit comments