gh-ost icon indicating copy to clipboard operation
gh-ost copied to clipboard

Document --alter

Open mjiderhamn opened this issue 4 years ago • 1 comments

It seems to me that nowhere in the documentation do you explain how to provide the actual migration/ALTER TABLE statement to gh-ost. A few places use --alter="engine=innodb" in examples, but it is far from obvious that "engine=innodb" is supposed to be the migration (as in ALTER TABLE my_table engine=innodb), rather than some configuration option.

Not even the command-line-flags.md mention --alter. Nor does the announcement blog post. Seem you need to look at third party blog posts, or be familiar with for example pt-online-schema-change, to know that --alter is used to pass the migration itself.

mjiderhamn avatar Jun 17 '21 09:06 mjiderhamn

Thank you! Would you be open to submit a PR with changes to the docs, with a few examples?

shlomi-noach avatar Jun 17 '21 09:06 shlomi-noach