Skip to content

Conversation

@aihuaxu
Copy link
Contributor

@aihuaxu aihuaxu commented Jul 22, 2025

Rationale for this change

Per Parquet's requirements, we need at least two reference implementations to finalize the Variant logical type specification and here are the current status:

Java already has the encoding and shredding implementations in place:
apache/parquet-java#3197
apache/parquet-java#3202
apache/parquet-java#3223
apache/parquet-java#3211

Go also includes encoding and shredding support:
apache/arrow-go#344
apache/arrow-go#434

We also have validated cross-language verification between Java and GO languages (apache/arrow-go#455 and apache/parquet-java#3258).

Rust is currently working on the shredding implementation. In addition to these, we already have a full Variant implementation in Apache Iceberg, as well as in some closed-source engines. At this point, I think we have enough implementation coverage to move forward with finalizing the Variant spec.

What changes are included in this PR?

Remove "under active development" notes from the doc.

Do these changes have PoC implementations?

Closes #508

@aihuaxu aihuaxu changed the title GH- :Finalize Variant and shredding specs GH-508: Finalize Variant and shredding specs Jul 22, 2025
Copy link
Contributor

@alamb alamb left a comment

Choose a reason for hiding this comment

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

From the Rust perspective (https://github.com/apache/arrow-rs) this works well

Thank you

Copy link
Member

@wgtmac wgtmac left a comment

Choose a reason for hiding this comment

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

The progress looks good. We can merge this once the vote passes.

Copy link
Contributor

@mrcnc mrcnc left a comment

Choose a reason for hiding this comment

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

🚀

@aihuaxu
Copy link
Contributor Author

aihuaxu commented Aug 24, 2025

The vote has passed and we are ready to merge this now. cc @Fokko and @wgtmac

@wgtmac wgtmac merged commit dac5a35 into apache:master Aug 25, 2025
4 checks passed
@wgtmac
Copy link
Member

wgtmac commented Aug 25, 2025

Thanks @aihuaxu for driving this!

jiayuasu pushed a commit to jiayuasu/parquet-format that referenced this pull request Oct 6, 2025
@amorynan
Copy link

Does Variant support top-array-struct ?

@aihuaxu
Copy link
Contributor Author

aihuaxu commented Oct 13, 2025

Does Variant support top-array-struct ?

@amorynan You mean nested variant such as ARRAY(variant), MAP<String, Variant>, right? I think we need some work there.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Finalize variant and shredding spec

6 participants