Struct MaterializedView

pub struct MaterializedView { /* private fields */ }

A materialized view in Apache Iceberg that maintains a physical copy of query results in a storage table. The view provides ACID guarantees and can be refreshed to stay in sync with changes in the source tables.

The materialized view consists of:

• A view definition (SQL or other representation)
• A storage table containing the materialized data
• Metadata tracking the freshness state relative to source tables

Implementations

impl MaterializedView

Public interface of the table.

pub fn builder() -> CreateMaterializedViewBuilder

Creates a new builder for configuring and creating a materialized view

Returns a CreateMaterializedViewBuilder that provides a fluent interface for:

• Setting the view name and location
• Configuring view properties
• Defining the view schema and SQL representation
• Specifying the catalog and storage table settings

pub async fn new( identifier: Identifier, catalog: Arc<dyn Catalog>, metadata: MaterializedViewMetadata, ) -> Result<Self, Error>

Creates a new materialized view instance with the given identifier, catalog and metadata

Arguments

• identifier - The unique identifier for this view in the catalog
• catalog - The catalog that will store this view’s metadata
• metadata - The view metadata containing schema, properties, etc.

Returns

• Result<MaterializedView, Error> - The created materialized view or an error

pub fn identifier(&self) -> &Identifier

Returns the unique identifier for this materialized view in the catalog

The identifier contains the namespace and name that uniquely identify this view within its catalog

pub fn catalog(&self) -> Arc<dyn Catalog>

Returns a reference to the catalog that stores this materialized view

The catalog manages the view’s metadata and provides ACID guarantees for operations on the view

pub fn current_schema(&self, branch: Option<&str>) -> Result<&Schema, Error>

Returns the current schema for this materialized view

Arguments

• branch - Optional branch name to get the schema for. If None, returns the main branch schema

Returns

• Result<&Schema, Error> - The current schema or an error if it cannot be found

pub fn metadata(&self) -> &MaterializedViewMetadata

Returns a reference to this materialized view’s metadata

The metadata contains the view’s schema, properties, version history, and other configuration details as defined by the Apache Iceberg spec

pub fn new_transaction( &mut self, branch: Option<&str>, ) -> MaterializedViewTransaction<'_>

Creates a new transaction for performing atomic operations on this materialized view

Arguments

• branch - Optional branch name to perform the transaction on. If None, uses the main branch

Returns

A new transaction that can be used to perform multiple operations atomically

pub async fn storage_table(&self) -> Result<StorageTable, Error>

Returns the storage table that contains the materialized data for this view

The storage table is a regular Iceberg table that stores the physical data for this materialized view. It is managed internally by the view and should not be modified directly.

Returns

• Result<StorageTable, Error> - The storage table or an error if it cannot be loaded

Trait Implementations

impl Clone for MaterializedView

fn clone(&self) -> MaterializedView

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MaterializedView

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

Formats the value using the given formatter.