Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/en/docs/File Format/implementationstatus.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,5 +28,5 @@ The value in each box means:
* [duckdb](https://github.com/duckdb/duckdb) (C++)
* [polars](https://github.com/pola-rs/polars) (Rust)

<!-- Status source in data/implementations -->
<!-- Data driven table, see /layouts/shortcodes -->

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I added a readme and new link in layouts/shortcodes

{{< implementation-status >}}
182 changes: 6 additions & 176 deletions content/en/docs/File Format/versions.md

Large diffs are not rendered by default.

31 changes: 24 additions & 7 deletions data/implementations/features/compressions.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,24 +2,41 @@ category_id: compressions
features:
- id: compression-uncompressed
display_name: UNCOMPRESSED

compatibility: forward_incompatible

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I added the various fields needed for the version page to the existing data files. I could probably make this less verbose by automatically generating the urls, but I think this is clearer and easier to understand

released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#uncompressed
- id: compression-brotli
display_name: BROTLI

compatibility: forward_incompatible
released_in: "2.4.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#brotli
- id: compression-gzip
display_name: GZIP

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#gzip
- id: compression-lz4-deprecated
display_name: LZ4 (deprecated)

compatibility: forward_incompatible
released_in: "2.4.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#lz4
- id: compression-lz4-raw
display_name: LZ4_RAW

compatibility: forward_incompatible
released_in: "2.9.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#lz4_raw
- id: compression-lzo
display_name: LZO

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#lzo
- id: compression-snappy
display_name: SNAPPY

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#snappy
- id: compression-zstd
display_name: ZSTD
compatibility: forward_incompatible
released_in: "2.4.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Compression.md#zstd
50 changes: 35 additions & 15 deletions data/implementations/features/encodings.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,37 +2,57 @@ category_id: encodings
features:
- id: encoding-plain
display_name: PLAIN

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#plain-plain--0
- id: encoding-plain-dictionary
display_name: PLAIN_DICTIONARY

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#dictionary-encoding-plain_dictionary--2-and-rle_dictionary--8
- id: encoding-rle-dictionary
display_name: RLE_DICTIONARY

compatibility: forward_incompatible
released_in: "2.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#dictionary-encoding-plain_dictionary--2-and-rle_dictionary--8
- id: encoding-rle
display_name: RLE

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#run-length-encoding--bit-packing-hybrid-rle--3
- id: encoding-bit-packed
display_name: BIT_PACKED (deprecated)

compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#bit-packed-deprecated-bit_packed--4
- id: encoding-delta-binary-packed
display_name: DELTA_BINARY_PACKED

compatibility: forward_incompatible
released_in: "2.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#delta-encoding-delta_binary_packed--5
- id: encoding-delta-length-byte-array
display_name: DELTA_LENGTH_BYTE_ARRAY

compatibility: forward_incompatible
released_in: "2.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#delta-length-byte-array-delta_length_byte_array--6
- id: encoding-delta-byte-array
display_name: DELTA_BYTE_ARRAY

compatibility: forward_incompatible
released_in: "2.0.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#delta-strings-delta_byte_array--7
- id: encoding-byte-stream-split
display_name: BYTE_STREAM_SPLIT
format_version:
version: "2.8.0"
date: "2020-01-13"

compatibility: forward_incompatible
released_in: "2.8.0"
release_date: '2020-01-13'
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#byte-stream-split-byte_stream_split--9
approval: "[2019-12-03](https://lists.apache.org/thread/xs5qt2odm299pxgqb22mty2csc1so5yr)"
- id: encoding-byte-stream-split-extended
display_name: BYTE_STREAM_SPLIT (Additional Types)
spec_url: https://github.com/apache/parquet-format/commit/e517ac4dbe08d518eb5c2e58576d4c711973db94
format_version:

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

some features already had a "format_version" which was redundant with the information from the versions page, so I consolidated them into the same fields

From

    format_version:
      version: "2.11.0"
      date: "2024-03-21"

To

    released_in: 2.11.0
    release_date: '2024-03-21'

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

my one concern is 2.11.0, interpretted properly as a string without quote marks?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Good idea -- I quoted them all in commit 9f8d58a

version: "2.11.0"
date: "2024-03-21"
version_display_name: BYTE_STREAM_SPLIT<br/>(Additional Types)
compatibility: forward_incompatible
released_in: "2.11.0"
release_date: '2024-03-21'
feature_url: https://github.com/apache/parquet-format/blob/master/Encodings.md#byte-stream-split-byte_stream_split--9
approval: "[2024-03-18](https://lists.apache.org/thread/nlsj0ftxy7y4ov1678rgy5zc7dmogg6q)"
80 changes: 58 additions & 22 deletions data/implementations/features/format-features.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,41 +3,77 @@ features:
- id: format-bloom-filters
display_name: xxHash-based bloom filters
spec_url: https://github.com/apache/parquet-format/blob/master/BloomFilter.md
format_version:
version: "2.7.0"
date: "2019-09-25"

compatibility: forward_compatible
released_in: "2.7.0"
release_date: '2019-09-25'
feature_url: https://github.com/apache/parquet-format/blob/master/BloomFilter.md
approval: "[2019-09-09](https://lists.apache.org/thread/ktdx1xp0d2gjfgkcvd29zxvt3cgg88bo)"
- id: format-bloom-filter-length
display_name: Bloom filter length
note: "In parquet.thrift: ColumnMetaData->bloom_filter_length"

note: 'In parquet.thrift: ColumnMetaData->bloom_filter_length'
compatibility: forward_compatible
released_in: "2.10.0"
feature_url: https://github.com/apache/parquet-format/blob/96656a543a2165d57cc1c9abefaad7f9aeb563a5/src/main/thrift/parquet.thrift#L933
- id: format-stats-min-max
display_name: Statistics min_value, max_value

- id: format-page-index
display_name: Page index
spec_url: https://github.com/apache/parquet-format/blob/master/PageIndex.md
format_version:
version: "2.4.0"
date: "2018-05-04"

compatibility: forward_compatible
released_in: "2.4.0"
release_date: '2018-05-04'
feature_url: https://github.com/apache/parquet-format/blob/master/PageIndex.md
- id: format-page-crc32
display_name: Page CRC32 checksum

compatibility: forward_compatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/96656a543a2165d57cc1c9abefaad7f9aeb563a5/src/main/thrift/parquet.thrift#L829
- id: format-modular-encryption
display_name: Modular encryption
spec_url: https://github.com/apache/parquet-format/blob/master/Encryption.md
format_version:
version: "2.7.0"
date: "2019-09-25"

compatibility: forward_incompatible
released_in: "2.7.0"
release_date: '2019-09-25'
feature_url: https://github.com/apache/parquet-format/blob/master/Encryption.md
approval: "[2019-01-16](https://lists.apache.org/thread/l8zcwnbrnhjh3w2k1lyb0v6ct5lnzr0h)"
- id: format-size-statistics
display_name: Size statistics
note: "In parquet.thrift: ColumnMetaData->size_statistics"
format_version:
version: "2.10.0"
date: "2023-11-20"

note: 'In parquet.thrift: ColumnMetaData->size_statistics'
compatibility: forward_compatible
released_in: "2.10.0"
release_date: '2023-11-20'
feature_url: https://github.com/apache/parquet-format/blob/96656a543a2165d57cc1c9abefaad7f9aeb563a5/src/main/thrift/parquet.thrift#L202
approval: "[2023-11-14](https://lists.apache.org/thread/wgobz41mfldbhqpg9q4mdwypghg2cxg2)"
- id: format-data-page-v2
display_name: Data Page V2
note: "In parquet.thrift: DataPageHeaderV2"
note: 'In parquet.thrift: DataPageHeaderV2'
compatibility: forward_incompatible
released_in: "2.0.0"
feature_url: https://github.com/apache/parquet-format/blob/96656a543a2165d57cc1c9abefaad7f9aeb563a5/src/main/thrift/parquet.thrift#L724
- id: format-data-page-v1
display_name: Data Page V1
implementation_status: false
compatibility: forward_incompatible
released_in: "1.0.0"
feature_url: https://github.com/apache/parquet-format/blob/96656a543a2165d57cc1c9abefaad7f9aeb563a5/src/main/thrift/parquet.thrift#L671
- id: format-geospatial-statistics
display_name: Geospatial statistics
implementation_status: false
compatibility: forward_compatible
released_in: "2.11.0"
feature_url: https://github.com/apache/parquet-format/blob/master/Geospatial.md#statistics
approval: "[2025-02-09](https://lists.apache.org/thread/s6s714c98cn9gg22mnk5nsn7xymym8xo)"
- id: format-binary-protocol-extensions
display_name: Binary protocol extensions
implementation_status: false
compatibility: forward_compatible
released_in: "2.11.0"
feature_url: https://github.com/apache/parquet-format/blob/master/BinaryProtocolExtensions.md
approval: "[2024-09-06](https://lists.apache.org/thread/x3472kldrq5kjnld9ztj1jozz25f40hg)"
- id: format-ieee-754-total-order-and-nan-counts
display_name: IEEE 754 total order and NaN counts
implementation_status: false
compatibility: forward_compatible
released_in: "2.13.0"
feature_url: https://github.com/apache/parquet-format/blob/master/src/main/thrift/parquet.thrift#L1061
approval: "[2026-05-26](https://lists.apache.org/thread/h0k0hqo0sojqphnbnrkp8b0gmwdzq9on)"
Loading
Loading