Working with Parquet in TypeScript
Updated Nov 12, 2026
Apache Parquet file handling for compressed columnar data.
Installation
npm install fairspecGetting Started
The Parquet plugin provides:
loadParquetTable- Load Parquet files into tablessaveParquetTable- Save tables to Parquet filesParquetPlugin- Plugin for framework integration
For example:
import { loadParquetTable } from "fairspec"
const table = await loadParquetTable({ data: "table.parquet" })
// Efficient columnar format with compressionLoaders return a nodejs-polars LazyDataFrame: call .collect() to get a DataFrame. Savers take any LazyDataFrame, so pass df.lazy() to save a DataFrame.
Basic Usage
Loading Parquet Files
import { loadParquetTable } from "fairspec"
// Load from local file
const local = await loadParquetTable({ data: "data.parquet" })
// Load from remote URL
const remote = await loadParquetTable({
data: "https://example.com/data.parquet",
})
// Load multiple files (concatenated)
const combined = await loadParquetTable({
data: ["file1.parquet", "file2.parquet"],
})Saving Parquet Files
import { saveParquetTable } from "fairspec"
// Save with default options
await saveParquetTable(table, { path: "output.parquet" })
// Save with explicit format
await saveParquetTable(table, {
path: "output.parquet",
fileDialect: { format: "parquet" },
})Advanced Features
Remote File Loading
import { loadParquetTable } from "fairspec"
// Load from URL
const remote = await loadParquetTable({
data: "https://example.com/data.parquet",
})
// Load multiple remote files
const remoteParts = await loadParquetTable({
data: [
"https://api.example.com/data-2023.parquet",
"https://api.example.com/data-2024.parquet",
],
})Created with ❤ and Livemark