Imports an Arrow-compatible file (Parquet, CSV, or JSONL) into a product primitive on the selected branch and space. Rows are written through the standard batch commands, so the import commits like any other write. Returns a summary of the target primitive, the input file, and the imported, skipped, and batch counts.

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

Examples

Import a primitive’s rows from a Parquet file written by export.

CLI

$ strata kv put greeting hello
$ strata arrow export kv parquet /tmp/exports/kv.parquet
$ strata kv delete greeting
$ strata arrow import /tmp/exports/kv.parquet kv  # Rows are keyed by their source column; kv restores greeting=hello.
$ 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 imports.
file_path	string	yes	Input file path.
format	ArrowFileFormat	no	Input file format. Defaults to extension detection.
key_column	string	no	Optional key column override.
target	ArrowImportTarget	yes	Product primitive to import into.
value_column	string	no	Optional value, document, or embedding column override.

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

Returns

StatusResponse<ArrowImport>.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.executor.arrow_feature_disabled
• invalid_argument.executor.arrow_format
• invalid_argument.executor.arrow_input_missing
• invalid_argument.executor.arrow_key_column
• invalid_argument.executor.arrow_value_column
• invalid_argument.executor.arrow_collection
• invalid_argument.executor.arrow_embedding_type
• invalid_argument.executor.arrow_vector_dimension
• invalid_argument.executor.arrow_json_key
• invalid_argument.executor.arrow_base64
• unavailable.executor.arrow_io
• internal.executor.arrow

Invocation

• CLI: strata arrow import
• Wire type: arrow_import