Struct Insert 

pub struct Insert<T: SurrealRecord> { /* private fields */ }

An INSERT INTO <table> … builder. Records are serialized inline as object literals; rendering requires T: serde::Serialize.

Implementations

impl<T: SurrealRecord> Insert<T>

pub fn content(self, record: T) -> Self

pub fn return_field(self, field: &'static str) -> Self

Add a field to the RETURN <projection> list. Multiple calls accumulate (RETURN id, name). Takes precedence over returning.

pub fn returning(self, r: Returning) -> Self

Set a RETURN NONE|BEFORE|AFTER|DIFF clause (used when no explicit return_field projection is given).

pub fn data(&self) -> &[T]

pub fn to_surrealql(&self) -> String

where T: Serialize,

Render INSERT INTO <table> <object|array> [RETURN …], serializing the queued record(s) inline as SurrealQL object literals (JSON is a valid subset). A single record renders as { … }, multiple as [ {…}, {…} ]. A RETURN projection (from return_field) renders the field list; otherwise the returning variant.