Struct UpdateBuilder 

pub struct UpdateBuilder<'a, M: Model> { /* private fields */ }

UPDATE query builder.

Example

// Update a model instance (uses primary key for WHERE)
update!(hero).execute(cx, &conn).await?;

// Update with explicit SET
UpdateBuilder::<Hero>::empty()
    .set("age", 26)
    .set("name", "New Name")
    .filter(Expr::col("id").eq(42))
    .execute(cx, &conn).await?;

// Update with RETURNING
let row = update!(hero).returning().execute_returning(cx, &conn).await?;

Implementations

impl<'a, M: Model> UpdateBuilder<'a, M>

pub fn new(model: &'a M) -> Self

Create a new UPDATE builder for the given model instance.

pub fn empty() -> Self

Create an empty UPDATE builder for explicit SET operations.

Use this when you want to update specific columns without a model instance.

pub fn set<V: Into<Value>>(self, column: &str, value: V) -> Self

Set a column to a specific value.

This can be used with or without a model instance. When used with a model, these explicit sets override the model values.

pub fn set_only(self, fields: &[&'static str]) -> Self

Only update specific fields from the model.

pub fn filter(self, expr: Expr) -> Self

Add a WHERE condition (defaults to primary key match).

pub fn returning(self) -> Self

Add RETURNING * clause to return the updated row(s).

pub fn build(&self) -> (String, Vec<Value>)

Build the UPDATE SQL and parameters with default dialect (Postgres).

pub fn build_with_dialect(&self, dialect: Dialect) -> (String, Vec<Value>)

Build the UPDATE SQL and parameters with specific dialect.

pub async fn execute<C: Connection>( self, cx: &Cx, conn: &C, ) -> Outcome<u64, Error>

Execute the UPDATE and return rows affected.

pub async fn execute_returning<C: Connection>( self, cx: &Cx, conn: &C, ) -> Outcome<Vec<Row>, Error>

Execute the UPDATE with RETURNING and get the updated rows.

Trait Implementations

impl<'a, M: Debug + Model> Debug for UpdateBuilder<'a, M>

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

Formats the value using the given formatter.