Parquet Viewer

A terminal-based Parquet file viewer with SQL query support built in Rust.

Features

• Parquet Metadata Viewing: View file metadata including row count, row groups, and columns
• SQL Query Support: Query Parquet files using SQL via DuckDB
• Interactive TUI: Terminal-based user interface with keyboard navigation
• Multi-platform: Builds for Linux, macOS, and Windows

Installation

From crates.io

cargo install parquet-viewer

From source

git clone https://github.com/Whoeason-que/parquet-viewer.git
cd parquet-viewer
cargo install --path .

Usage

Run the viewer:

parquet-viewer

Or with a file:

parquet-viewer /path/to/file.parquet

Keyboard Shortcuts

• Tab - Switch focus between File Path, SQL input, and Results table
• Enter - Load file / Execute SQL query
• Ctrl+E - Toggle SQL input between single-line and expanded mode
• Esc - Quit
• j/k or ↑/↓ - Navigate result table (when focused)
• Home/End - Jump to start/end of input or table

Example

1. Enter the path to a Parquet file
2. Press Enter to load the file
3. The default SQL query SELECT * FROM my_table LIMIT 100 will execute
4. Modify the SQL query as needed and press Enter to execute
5. Use Tab to navigate between sections

Dependencies

• Rust 2024 edition
• ratatui - Terminal UI framework
• crossterm - Cross-platform terminal manipulation
• parquet - Apache Parquet format support
• arrow - Arrow columnar format
• duckdb - In-process SQL database

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.