Compare commits

...

2 Commits

Author SHA1 Message Date
Max Wagner
597eb30010 Define alter cli flag
This flag not really documented, hopefully this clears up the intent.
2020-11-13 15:24:15 -07:00
Max Wagner
a93f00ae8e Add some hints and tips for using RDS
I had a little trouble figuring out how to configure the binlog format,
hopefully this will help some others.
2020-11-13 15:23:55 -07:00
2 changed files with 17 additions and 4 deletions

View File

@ -16,6 +16,10 @@ By default, `gh-ost` would like you to connect to a replica, from where it figur
If, for some reason, you do not wish `gh-ost` to connect to a replica, you may connect it directly to the master and approve this via `--allow-on-master`.
### alter
This manadatory flag is the `ALTER` statement migrated to the ghost table.
### approve-renamed-columns
When your migration issues a column rename (`change column old_name new_name ...`) `gh-ost` analyzes the statement to try and associate the old column name with new column name. Otherwise the new structure may also look like some column was dropped and another was added.

View File

@ -5,7 +5,9 @@
## Limitations
- No `SUPER` privileges.
- Editing `binlog_format` not allowed, see next bullet.
- `gh-ost` runs should be setup use [`--assume-rbr`][assume_rbr_docs] and use `binlog_format=ROW`.
- See [this tip](#binlog_format) on how to change the `binlog_format`.
- Aurora does not allow editing of the `read_only` parameter. While it is defined as `{TrueIfReplica}`, the parameter is non-modifiable field.
## Aurora
@ -53,3 +55,10 @@ Before trying to run any `gh-ost` migrations you will want to confirm the follow
[ghost_hooks]: https://github.com/github/gh-ost/blob/master/doc/hooks.md
[ghost_rds_issue_tracking]: https://github.com/github/gh-ost/issues/163
[aws_replication_docs_bin_log_filtering]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Replication.html#AuroraMySQL.Replication.Performance
## Other Tips & Tricks
## binlog_format
On a normal RDS instance, if you need to switch to `binlog_format=ROW`, you can do so by creating a [RDS Parameter Group](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html).
During the Parameter Group creation process, set `binlog_format` to `ROW`. After creating the Parameter group, you can modify you RDS instance to use it.