Struct Update 

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

An UPDATE/UPSERT builder: SET / MERGE / CONTENT, an optional WHERE, and RETURN. Built via Table::update or Table::upsert.

Implementations

impl<T: SurrealRecord> Update<T>

pub fn record<V: SurrealQL>(self, id: V) -> Self

Target a single record: UPDATE type::record('table', <id>).

pub fn filter(self, expr: impl DynExpr + 'static) -> Self

pub fn set<C: SurrealQL>(self, col: Column<T, C>, value: C) -> Self

SET col = <literal>.

pub fn set_lit<C: SurrealQL>(self, col: impl Into<String>, value: C) -> Self

SET col = <literal> by raw column name.

pub fn set_expr( self, col: impl Into<String>, expr: impl DynExpr + 'static, ) -> Self

SET col = <expr> — e.g. a record link, time::now(), NONE, use_count + 1.

pub fn set_raw(self, col: impl Into<String>, raw: impl Into<String>) -> Self

SET col = <raw SurrealQL>.

pub fn merge(self, expr: impl DynExpr + 'static) -> Self

MERGE <expr> — deep-merge the given object into the record.

pub fn content(self, expr: impl DynExpr + 'static) -> Self

CONTENT <expr> — full-replace the record’s content (upsert by record id).

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

pub fn then_select(self, select: Select<T>) -> String

Follow this UPDATE with a reselecting Select, joined as a ;-separated batch. See Create::then_select for motivation.

pub fn then_select_params( self, select: Select<T>, ) -> (String, BTreeMap<String, Value>)

Like then_select but renders with $param placeholders.

pub fn to_surrealql(&self) -> String

pub fn to_surrealql_with_params(&self) -> (String, BTreeMap<String, Value>)

Render with $param placeholders instead of inlined literals.

Trait Implementations

impl<T: SurrealRecord> Display for Update<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.