jorisvandenbossche commented on a change in pull request #11844:
URL: https://github.com/apache/arrow/pull/11844#discussion_r763168499
##########
File path: docs/source/python/dataset.rst
##########
@@ -340,6 +340,30 @@ when constructing a directory partitioning:
Directory partitioning also supports providing a full schema rather than
inferring
types from file paths.
+Automatic partitioning detection
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the directory is partitioned using the hive partitioning scheme (see above)
+then pyarrow will be able to automatically recognize the partitioning and
include
+the partitioning information as a column in the returned table. There is no
+need to specify the partitioning unless you need to override the inferred data
+types of the partitioning columns:
+
+.. code-block:: python
+
+ dataset = ds.dataset("hive_partitioned", format="parquet")
Review comment:
To add to the confusion, on the issue you mentioned
`pd.parquet_parquet`, which goes through `parquet.read_table/ParquetDataset`,
and those paths will actually infer hive partitioning. But so not
`ds.dataset(..)` ...
The default here is set to `partitioning="hive"`:
https://github.com/apache/arrow/blob/ad1fd0495bc543107a8d882506263906f330f2c5/python/pyarrow/parquet.py#L1935-L1938
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
