Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Online DDL: remove legacy "stowaway table" logic #12288

Merged

Conversation

shlomi-noach
Copy link
Contributor

@shlomi-noach shlomi-noach commented Feb 9, 2023

Description

The "stowaway table" was part of the previous vitess cut-over mechanism, described in https://vitess.io/blog/2022-04-06-online-ddl-vitess-cut-over/

However, the logic has changed in #11460. We no longer use a stowaway table in the cut-over mechanism. The stowaway table was the place where we would store our original table at cut-over phase. But because the cut-over was not atomic, we had to journal that changed. That was done with the stowaway_table column in _vt.schema_migrations. We would check this value to be able to rollback a halfway executed migration.

Anyway, now we use atomic cutover. We have a "sentry table" now. But this isn't merely a change of name. The sentry table is ephemeral. That is, it's a real table, but we don't care what happens to it. It's temporary in use. There's no situation where we have to resurrect it.

This PR cleans up all the stowaway table logic, which is unused now. To clarify how unused it is, the only scenario where anyone would still need this logic is if they had a failover during a cut-over phase, and at the same time chose to upgrade their vitess cluster. Which is unreasonable.

Related Issue(s)

Checklist

  • "Backport to:" labels have been added if this change should be back-ported
  • Tests were added or are not required
  • Documentation was added or is not required

Deployment Notes

Signed-off-by: Shlomi Noach <2607934+shlomi-noach@users.noreply.github.com>
@shlomi-noach shlomi-noach added Type: Internal Cleanup Component: Online DDL Online DDL (vitess/native/gh-ost/pt-osc) labels Feb 9, 2023
@vitess-bot vitess-bot bot added NeedsDescriptionUpdate The description is not clear or comprehensive enough, and needs work NeedsWebsiteDocsUpdate What it says labels Feb 9, 2023
@vitess-bot
Copy link
Contributor

vitess-bot bot commented Feb 9, 2023

Review Checklist

Hello reviewers! 👋 Please follow this checklist when reviewing this Pull Request.

General

  • Ensure that the Pull Request has a descriptive title.
  • If this is a change that users need to know about, please apply the release notes (needs details) label so that merging is blocked unless the summary release notes document is included.
  • If a test is added or modified, there should be a documentation on top of the test to explain what the expected behavior is what the test does.

If a new flag is being introduced:

  • Is it really necessary to add this flag?
  • Flag names should be clear and intuitive (as far as possible)
  • Help text should be descriptive.
  • Flag names should use dashes (-) as word separators rather than underscores (_).

If a workflow is added or modified:

  • Each item in Jobs should be named in order to mark it as required.
  • If the workflow should be required, the maintainer team should be notified.

Bug fixes

  • There should be at least one unit or end-to-end test.
  • The Pull Request description should include a link to an issue that describes the bug.

Non-trivial changes

  • There should be some code comments as to why things are implemented the way they are.

New/Existing features

  • Should be documented, either by modifying the existing documentation or creating new documentation.
  • New features should have a link to a feature request issue or an RFC that documents the use cases, corner cases and test cases.

Backward compatibility

  • Protobuf changes should be wire-compatible.
  • Changes to _vt tables and RPCs need to be backward compatible.
  • vtctl command output order should be stable and awk-able.
  • RPC changes should be compatible with vitess-operator
  • If a flag is removed, then it should also be removed from VTop, if used there.

@shlomi-noach shlomi-noach removed NeedsDescriptionUpdate The description is not clear or comprehensive enough, and needs work NeedsWebsiteDocsUpdate What it says labels Feb 9, 2023
Copy link
Contributor

@mattlord mattlord left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Signed-off-by: Shlomi Noach <2607934+shlomi-noach@users.noreply.github.com>
@shlomi-noach
Copy link
Contributor Author

shlomi-noach commented Feb 12, 2023

Shouldn't we remove it from the schema here too?

Yes, indeed. Done.

Copy link
Member

@deepthi deepthi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume no tests directly tested this internal detail.

@deepthi deepthi merged commit 414b185 into vitessio:main Feb 15, 2023
@deepthi deepthi deleted the onlineddl-remove-stowaway-table-logic branch February 15, 2023 23:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Component: Online DDL Online DDL (vitess/native/gh-ost/pt-osc) Type: Internal Cleanup
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants