arrange: Sort rows by column values

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

Sort rows by column values

Description

Sort rows by column values

Usage

arrange(.data, ...)

Arguments

.data	A vectra_node object.
...	Column names (unquoted). Wrap in desc() for descending order.

Details

Uses an external merge sort with a 1 GB memory budget. When data exceeds this limit, sorted runs are spilled to temporary .vtr files and merged via a k-way min-heap. NAs sort last in ascending order.

This is a materializing operation.

Value

A new vectra_node with sorted rows.

Examples

f <- tempfile(fileext = ".vtr")
write_vtr(mtcars, f)
tbl(f) |> arrange(desc(mpg)) |> collect() |> head()
unlink(f)

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