Skip to content

Commit 9e47fbb

Browse files
authored
GH-50227: [Docs][Python][Parquet] Update parquet default version text in parquet.rst (#50228)
### Rationale for this change See #50227 - Python Parquet section [Storing timestamps](https://arrow.apache.org/docs/dev/python/parquet.html#storing-timestamps) mentions version 1.0 is the default write version but the actual [default has been 2.6 ](https://github.com/apache/arrow/blame/98ee71ec2be85d3ac535be367c6edacc0bc09c7c/python/pyarrow/parquet/core.py#L1996) for some time. (Replace old pr #37227) ### What changes are included in this PR? Update the default Parquet version text 1.0 -> 2.6 in `docs/source/python/parquet.rst`. ### Are these changes tested? Docs build fine locally. ### Are there any user-facing changes? No. * GitHub Issue: #50227 Authored-by: Tadeja Kadunc <tadeja.kadunc@gmail.com> Signed-off-by: AlenkaF <frim.alenka@gmail.com>
1 parent 99084bb commit 9e47fbb

1 file changed

Lines changed: 8 additions & 9 deletions

File tree

docs/source/python/parquet.rst

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -368,9 +368,9 @@ Storing timestamps
368368

369369
Some Parquet readers may only support timestamps stored in millisecond
370370
(``'ms'``) or microsecond (``'us'``) resolution. Since pandas uses nanoseconds
371-
to represent timestamps, this can occasionally be a nuisance. By default
372-
(when writing version 1.0 Parquet files), the nanoseconds will be cast to
373-
microseconds ('us').
371+
to represent timestamps, this can occasionally be a nuisance. When writing
372+
older ``version='1.0'`` or ``version='2.4'`` Parquet files, the nanoseconds
373+
will be cast to microseconds (``'us'``).
374374

375375
In addition, We provide the ``coerce_timestamps`` option to allow you to select
376376
the desired resolution:
@@ -388,17 +388,16 @@ an exception will be raised. This can be suppressed by passing
388388
>>> pq.write_table(table, 'example.parquet', coerce_timestamps='ms',
389389
... allow_truncated_timestamps=True)
390390
391-
Timestamps with nanoseconds can be stored without casting when using the
392-
more recent Parquet format version 2.6:
391+
Timestamps with nanoseconds can be stored without casting when using
392+
Parquet format version 2.6, which is the default:
393393

394394
.. code-block:: python
395395
396396
>>> pq.write_table(table, 'example.parquet', version='2.6')
397397
398-
However, many Parquet readers do not yet support this newer format version, and
399-
therefore the default is to write version 1.0 files. When compatibility across
400-
different processing frameworks is required, it is recommended to use the
401-
default version 1.0.
398+
However, some Parquet readers may not yet support this newer format version.
399+
When compatibility across different processing frameworks is required, the
400+
older ``version='1.0'`` or ``version='2.4'`` remain available.
402401

403402
Older Parquet implementations use ``INT96`` based storage of
404403
timestamps, but this is now deprecated. This includes some older

0 commit comments

Comments
 (0)