Interface SqlCatalog

nodedb-sql/src/catalog.rs:68–88

Trait for looking up collection metadata during planning. Both Origin (via CredentialStore) and Lite (via the embedded redb catalog) implement this trait. The return type is `Result , _>` with a three-way semantics: - `Ok(Some(info))` — the collection exists and is usable. An Origin implementation will have acquired a descriptor lease at the current version before returnin

///   Callers propagate this up so the pgwire layer can retry
///   the whole statement.
pub trait SqlCatalog {
    fn get_collection(
        &self,
        database_id: DatabaseId,
        name: &str,
    ) -> Result<Option<CollectionInfo>, SqlCatalogError>;

    /// Look up an array by name. Returns `None` if no array with that
    /// name is registered. The default implementation returns `None` so
    /// that catalog adapters predating array support compile without
    /// change — the array DML planner falls back to "array not found"
    /// in that case.
    fn lookup_array(&self, _name: &str) -> Option<ArrayCatalogView> {
        None
    }

    /// Cheap existence check; the default delegates to `lookup_array`.
    fn array_exists(&self, name: &str) -> bool {
        self.lookup_array(name).is_some()
    }
}

/// View of a registered array, surfaced to the SQL planner. Decoded by
/// the runtime catalog adapter from its persisted msgpack schema blob;