Skip to content

Commit d6347c4

Browse files
author
Shlomi Noach
committed
adding common-questions doc page
1 parent 5af7026 commit d6347c4

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

doc/questions.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# How?
2+
3+
### How does the cut-over work? Is it really atomic?
4+
5+
The cut-over phase, where the original table is swapped away, and the _ghost_ table takes its place, is an atomic, blocking, controlled operation.
6+
7+
- Atomic: the tables are swapped together. There is no gap where your table does not exist.
8+
- Blocking: all app queries involving the migrated (original) table are either operate on the original table, or are blocked, or proceed to operate on the _new_ table (formerly the _ghost_ table, now swapped in).
9+
- Controlled: the cut-over times out at pre-defined threshold, and is atomically aborted, then re-attempted. Cut-over only takes place when no lags are present, and otherwise no throttling reason is found. Cut-over step itself gets high priority and is never throttled.
10+
11+
Read more on [cut-over](cut-over.md) and on the [cut-over design Issue](https://github.com/github/gh-ost/issues/82)
12+
13+
14+
# Is it possible to?
15+
16+
### Is it possible to add a UNIQUE KEY?
17+
18+
Adding a `UNIQUE KEY` is possible, in the condition that no violation will occur. That is, you must make sure there aren't any violating rows on your table before, and during the migration.
19+
20+
At this time there is no equivalent to `ALETER IGNORE`, where duplicates are implicitly and silently thrown away. This behavior may be supported in the future.
21+
22+
# Why

0 commit comments

Comments
 (0)