apache / apache/parquet-format

Define core features / compliance level

Open
#384 10 comments 0 reactions 0 assignees View on GitHub
Priority: Major Type: enhancement
Dominant language
Thrift
Stars
2.6k
Forks
508
Avg merge
2d 8h
Merged PRs (30d)
4

Description

Parquet format is getting more and more features while the different implementations cannot keep the pace and left behind with some features implemented and some are not. In many cases it is also not clear if the related feature is mature enough to be used widely or more an experimental one.
These are huge issues that makes hard ensure interoperability between the different implementations.

The following idea came up in a [discussion](https://lists.apache.org/thread.html/rde5cba8443487bccd47593ddf5dfb39f69c729d260165cb936a1a289%40%3Cdev.parquet.apache.org%3E). Create a now document in the parquet-format repository that lists the "core features". This document is versioned by the parquet-format releases. This way a certain version of "core features" defines a level of compatibility between the different implementations. This version number can be written to a new field (e.g. complianceLevel) in the footer. If an implementation writes a file with a version in the field it must implement all the related "core features" (read and write) and must not use any other features at write because it makes the data unreadable by another implementation if only the same level of "core features" are implemented.
For example if we have encoding A listed in the version 1 "core features" but encoding B is not then at "complianceLevel = 1" we can use encoding A but we cannot use encoding B because it would make the related data unreadable.

**Reporter**: [Gabor Szadovszky](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=gszadovszky) / @gszadovszky
**Assignee**: [Gabor Szadovszky](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=gszadovszky) / @gszadovszky

**Note**: *This issue was originally created as [PARQUET-1950](https://issues.apache.org/jira/browse/PARQUET-1950). Please see the [migration documentation](https://issues.apache.org/jira/browse/PARQUET-2502) for further details.*

Contributor guide

Open the contributing guide

Research direction

Start with the linked discussion and the parquet-format repository's existing release and format-version documentation; no implementation file or test is named. Define the versioned core-features document and specify how a complianceLevel in the footer maps to required read/write features and permitted encodings. Done means the compatibility rules and versioning are agreed and documented.

Written by the indexing model from the issue text.

Assessment

Domain
data-engineering
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.