Skip to content

Conversation

@Jiashu-Hu
Copy link
Contributor

Which issue does this PR close?

Rationale for this change

Added some description about DFSchema and Schema for make user easy to understanding and easy to use

What changes are included in this PR?

Updated documentation we a new section "Arrow Schema and DataFusion DFSchema"

Are these changes tested?

No need to test

Are there any user-facing changes?

Yes, documentation is user-facing changes

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 20, 2025
From Schema to DFSchema: Use `DFSchema::try_from_qualified_schema` with a table name and original schema. See example below:

> let df_schema = DFSchema::try_from_qualified_schema("t1", &arrow_schema).unwrap();
Copy link
Contributor

Choose a reason for hiding this comment

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

For conversion it is worth to point to DFSchema link documentation https://docs.rs/datafusion/latest/datafusion/common/struct.DFSchema.html#converting-back-to-arrow-schema

Other conversion methods which are suitable for users it is nice to document in the rust doc

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hi Comphead, thank you for your review! Your advice is really helpful, I've made changes based on your advice and pushed a new version for you to review.

@Jiashu-Hu Jiashu-Hu force-pushed the Dcoument/updateDFSchemaDescription branch from d3b3c27 to f54060e Compare March 21, 2025 16:47
Copy link
Contributor

@comphead comphead left a comment

Choose a reason for hiding this comment

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

lgtm thanks @Jiashu-Hu

@comphead comphead merged commit 8756197 into apache:main Mar 21, 2025
11 of 12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] Add info on type system (DFSchema/Schema) to user guide

2 participants