Struct iceberg_datafusion::IcebergCatalogProvider

pub struct IcebergCatalogProvider { /* private fields */ }

Provides an interface to manage and access multiple schemas within an Iceberg Catalog.

Acts as a centralized catalog provider that aggregates multiple [SchemaProvider], each associated with distinct namespaces.

Implementations

impl IcebergCatalogProvider

pub async fn try_new(client: Arc<dyn Catalog>) -> Result<Self>

Asynchronously tries to construct a new IcebergCatalogProvider using the given client to fetch and initialize schema providers for each namespace in the Iceberg Catalog.

This method retrieves the list of namespace names attempts to create a schema provider for each namespace, and collects these providers into a HashMap.

Trait Implementations

impl CatalogProvider for IcebergCatalogProvider

fn as_any(&self) -> &dyn Any

Returns the catalog provider as Any so that it can be downcast to a specific implementation.

fn schema_names(&self) -> Vec<String>

Retrieves the list of available schema names in this catalog.

fn schema(&self, name: &str) -> Option<Arc<dyn SchemaProvider>>

Retrieves a specific schema from the catalog by name, provided it exists.

fn register_schema( &self, name: &str, schema: Arc<dyn SchemaProvider>, ) -> Result<Option<Arc<dyn SchemaProvider>>, DataFusionError>

Adds a new schema to this catalog.

fn deregister_schema( &self, _name: &str, _cascade: bool, ) -> Result<Option<Arc<dyn SchemaProvider>>, DataFusionError>

Removes a schema from this catalog. Implementations of this method should return errors if the schema exists but cannot be dropped. For example, in DataFusion’s default in-memory catalog, MemoryCatalogProvider, a non-empty schema will only be successfully dropped when cascade is true. This is equivalent to how DROP SCHEMA works in PostgreSQL.

impl Debug for IcebergCatalogProvider

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

Formats the value using the given formatter.