[ARROW-8047] [Python][Documentation] Document migration from ParquetDataset to pyarrow.datasets

• Type: Improvement
• Status: Open
• Priority: Critical
• Resolution: Unresolved
• Affects Version/s: 0.16.0
• Component/s: Documentation, Python
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/24261
• Assignee: Unassigned
• Reporter: Ben Kietzman
• Created: 09/Mar/20 21:11
• Updated: 11/Jan/23 07:57

Description

We need documentation describing a migration path from ParquetDataset, at least for the basic user facing API of ParquetDataset (As I read it, that's: construction, projection, filtering, threading, for a first pass). Following this we could mark ParquetDataset as deprecated, building features needed by power users like dask and adding those to the migration document

Issue Links

• is related to: ARROW-9720 [Python] Long-term fate of pyarrow.parquet.ParquetDataset
• is related to: ARROW-8063 [Python] Add user guide documentation for Datasets API