[DOCS] Add documentation around downgrading hudi table#9704
Merged
nsivabalan merged 2 commits intoapache:asf-sitefrom Sep 14, 2023
Merged
[DOCS] Add documentation around downgrading hudi table#9704nsivabalan merged 2 commits intoapache:asf-sitefrom
nsivabalan merged 2 commits intoapache:asf-sitefrom
Conversation
Collaborator
Author
|
nsivabalan
requested changes
Sep 14, 2023
website/docs/deployment.md
Outdated
|
|
||
| - [Deployment Model](#deploying) : How various Hudi components are deployed and managed. | ||
| - [Upgrading Versions](#upgrading) : Picking up new releases of Hudi, guidelines and general best-practices. | ||
| - [Upgrading/Downgrading Versions](#upgrading--downgrading) : Picking up new releases of Hudi, guidelines and general best-practices. |
Contributor
There was a problem hiding this comment.
minor.
we can make Upgrading and Downgrading as two diff bullets.
and fix the desc for downgrade.
website/docs/deployment.md
Outdated
| - Always upgrade/downgrade the query bundles (mr-bundle, presto-bundle, spark-bundle) first and then upgrade/downgrade the writers (Hudi Streamer, spark jobs using datasource). This often provides the best experience and it's easy to fix | ||
| any issues by rolling forward/back the writer code (which typically you might have more control over) | ||
| - With large, feature rich releases we recommend migrating slowly, by first testing in staging environments and running your own tests. Upgrading Hudi is no different than upgrading any database system. | ||
| - With large, feature rich releases we recommend migrating slowly, by first testing in staging environments and running your own tests. Upgrading/Downgrading Hudi is no different than upgrading/downgrading any database system. |
Contributor
There was a problem hiding this comment.
Lets not combine Upgrading and downgrading.
lets add a new section for downgrade.
Few things to consider
- Lets call out that upgrade steps will get executed automatically when new hudi version is used and there is not human intervention required.
- With downgrade, lets go over an example script. Create a table using 0.12.0. And then upgrade to 0.13.0. And then launch cli and execute downgrade.
- Also, in downgrade lets add some explanation as to why someone might need to downgrade (motivation)
nsivabalan
approved these changes
Sep 14, 2023
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Change Logs
Adds documentation in the deployment guide for downgrading a hudi table. Currently the documentation only discusses the Upgrade steps.
Impact
NA
Risk level (write none, low medium or high below)
low
Documentation Update
NA
Contributor's checklist