SurrealDB icon

SurrealDB

Interaction with a SurrealDB database

Batch → Batch Create

AI-generated

Summary

Create multiple records in a specified SurrealDB table by processing an array of record objects in batches with configurable batch size, parallelism, error handling, and transaction options.

Inputs

  • Table (required) — The SurrealDB table name where records will be created, e.g., "person", "product", "order".
  • Records Data (JSON) (required) — A JSON array of record objects to be created or upserted in the specified table.
  • Batch Configuration — Optional settings to control batch processing behavior, including batch size (1–1000 records), whether to process batches in parallel, max parallel batches (1–10), error handling strategy (stop on first error, continue on errors, or partial success), execution in a single transaction, and progress tracking.
  • Options — Additional optional settings to override the default namespace and database for this operation.
  • Connection Pooling — Optional configuration for connection pooling settings such as max/min connections, acquire timeout, health check intervals, retry attempts, and validation to optimize database connections during batch execution.

Output shape

a list of results for each processed batch, indicating success or failure along with created record data or error details

Results reflect batch processing according to the configured error handling mode. Progress tracking reports batch processing status if enabled. Namespace and database options override credential defaults if specified.

Links

Discussion