tbl_csv: Create a lazy table reference from a CSV file

In vectra: Columnar Query Engine for Larger-than-RAM Data

Create a lazy table reference from a CSV file

Description

Opens a CSV file for lazy, streaming query execution. Column types are inferred from the first 1000 rows. No data is read until collect() is called. Gzip-compressed files (.csv.gz) are supported transparently.

Usage

tbl_csv(path, batch_size = .DEFAULT_BATCH_SIZE)

Arguments

path	Path to a .csv or .csv.gz file.
batch_size	Number of rows per batch (default 65536).

Value

A vectra_node object representing a lazy scan of the CSV file.

Examples

f <- tempfile(fileext = ".csv")
write.csv(mtcars, f, row.names = FALSE)
node <- tbl_csv(f)
print(node)
unlink(f)

vectra documentation built on May 8, 2026, 9:06 a.m.