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

Docs: Add rewrite-table-path in spark procedure #12115

Open
wants to merge 11 commits into
base: main
Choose a base branch
from

Conversation

dramaticlly
Copy link
Contributor

@dramaticlly dramaticlly commented Jan 27, 2025

Documentation for #11931 #11555

I took wording and docs with original author of @flyrain and @szehon-ho
Also @manuzhang is interested in this and wondering if @amogh-jahagirdar is ready to take this as part of 1.8

@github-actions github-actions bot added the docs label Jan 27, 2025
@dramaticlly
Copy link
Contributor Author

thank you @flyrain @RussellSpitzer for the promptly review, updated per your suggestion!

Co-authored-by: Russell Spitzer <[email protected]>
@dramaticlly
Copy link
Contributor Author

thank you Russell for the detailed review! This is getting closer and I did a local check to ensure the info and warning section rendered as expected like in following screenshot. image

docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
Copy link
Collaborator

@szehon-ho szehon-ho left a comment

Choose a reason for hiding this comment

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

Thanks, looks better, some more nits

docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Show resolved Hide resolved
Copy link
Contributor

@flyrain flyrain left a comment

Choose a reason for hiding this comment

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

LGTM with a minor comment. Thanks for doing this!

@dramaticlly
Copy link
Contributor Author

With #11929 merged, I can remove the warning in the documentation for table with statistics files

docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
docs/docs/spark-procedures.md Outdated Show resolved Hide resolved
## Table Replication

The `rewrite-table-path` procedure prepares an Iceberg table for moving or copying to another location.
Copy link
Collaborator

Choose a reason for hiding this comment

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

How can we achieve moving with this procedure?

Stages a copy of the Iceberg table's metadata files where every absolute path source prefix is replaced by the specified target prefix.
This can be the starting point to fully or incrementally copy an Iceberg table located under an absolute path under a
source prefix to another under the target prefix.
Copy link
Collaborator

Choose a reason for hiding this comment

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

"under an absolute path under a source prefix to another under the target prefix." is not easy to grok.


!!! info
This procedure only prepares metadata or/and data files for an existing Iceberg table for copying or moving to a new location.
Copy link
Collaborator

@manuzhang manuzhang Feb 8, 2025

Choose a reason for hiding this comment

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

Data files here means delete files, right?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants