Parquet Import

Import existing Parquet files directly into Arc. Useful for data lake integration, analytics pipeline output, or migrating from other columnar stores.

Endpoint

POST /api/v1/import/parquet

Headers

Query parameters

Example

curl -X POST "http://localhost:8000/api/v1/import/parquet?measurement=metrics" \
  -H "Authorization: Bearer $ARC_TOKEN" \
  -H "X-Arc-Database: production" \
  -F "file=@data_export.parquet"

Response

{
  "status": "ok",
  "result": {
    "database": "production",
    "measurement": "metrics",
    "rows_imported": 1200000,
    "partitions_created": 8,
    "time_range_min": "2026-01-01T00:00:00Z",
    "time_range_max": "2026-01-01T07:45:00Z",
    "columns": ["time", "host", "region", "cpu_usage", "mem_usage"],
    "duration_ms": 890
  }
}

Notes

• The Parquet file must contain a timestamp column (default name: time). Use the time_column parameter if your column has a different name. The time column may be an Arrow TIMESTAMP (any unit), an integer epoch column (any width), a floating-point epoch column (use time_format, or auto-detect by magnitude), or a timestamp string column.
• Arc reads the Parquet file in-process via Apache Arrow and repartitions the data into Arc's hourly partition layout regardless of the source file's structure. Supported column types: integer (all widths, signed and unsigned), floating point, boolean, string, binary/byte-array, decimal (imported as DOUBLE), and timestamp.
• DECIMAL columns are imported as DOUBLE. If you need exact decimal precision, use Line Protocol ingestion with a configured decimal column.
• Maximum file size: 500 MB.
• RBAC: write permissions are checked for the target measurement.

Error responses