Struct UpdateSchemaAction 

pub struct UpdateSchemaAction { /* private fields */ }

Schema evolution API modeled after the Java SchemaUpdate implementation.

This action accumulates schema modifications (column additions and deletions) via builder methods. At commit time, it validates all operations against the current table schema, auto-assigns field IDs from table.metadata().last_column_id(), builds a new schema, and emits AddSchema + SetCurrentSchema updates with a CurrentSchemaIdMatch requirement.

Example

let tx = Transaction::new(&table);
let action = tx.update_schema()
    .add_column(AddColumn::optional("new_col", Type::Primitive(PrimitiveType::Int)))
    .add_column(
        AddColumn::optional("email", Type::Primitive(PrimitiveType::String))
            .with_parent("person")
    )
    .delete_column("old_col");
let tx = action.apply(tx).unwrap();
let table = tx.commit(&catalog).await.unwrap();

Implementations

impl UpdateSchemaAction

pub fn add_column(self, add_column: AddColumn) -> Self

Add a column to the table schema.

To add a root-level column, leave AddColumn::parent as None. For nested additions, set a parent path. If the parent resolves to a map/list, the column is added to map value/list element.

pub fn delete_column(self, name: impl ToString) -> Self

Record a column deletion by name.

At commit time, the column must exist in the current schema.