Export Arrow file — StrataDB Docs

Docs menu · Reference

Exports a product primitive from the selected branch and space to an Arrow-compatible file (Parquet, CSV, or JSONL). Graph exports treat the path as a stem and write separate node and edge files. Returns a summary of the exported primitive, the concrete output paths, the row count, and the total output size.

Status commands return a scalar or compact status payload and do not mutate database state.

Examples

Export a primitive to a Parquet file, then import it back.

CLI

$ strata kv put greeting hello
$ strata arrow export kv parquet /tmp/exports/kv.parquet  # One file per primitive; Parquet by default.
$ strata kv delete greeting
$ strata arrow import /tmp/exports/kv.parquet kv
$ strata kv get greeting

Wire

{"key":"Z3JlZXRpbmc=","type":"kv_put","value":"aGVsbG8="}
{"format":"parquet","path":"/tmp/exports/kv.parquet","primitive":"kv","type":"arrow_export"}
{"key":"Z3JlZXRpbmc=","type":"kv_delete"}
{"file_path":"/tmp/exports/kv.parquet","target":"kv","type":"arrow_import"}
{"key":"Z3JlZXRpbmc=","type":"kv_get"}

Parameters

Name	Type	Required	Description
`collection`	`string`	no	Target vector collection for vector exports.
`event_type`	`string`	no	Optional event type filter for event exports.
`format`	`ArrowFileFormat`	yes	Output file format.
`graph`	`string`	no	Target graph for graph exports.
`limit`	`integer`	no	Optional row limit.
`path`	`string`	yes	Output file path. Graph exports treat this as a stem and return concrete node and edge paths.
`prefix`	`string`	no	Optional key, document, vector-key, or node-id prefix.
`primitive`	`ArrowExportPrimitive`	yes	Product primitive to export.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

StatusResponse<ArrowExport>.

Errors

Invocation

CLI: strata arrow export
Wire type: arrow_export

agents: this page as markdown → /docs/reference/arrow/export.md