Trait DataSource

Source

pub trait DataSource:
    Debug
    + Send
    + Sync {
    // Required methods
    fn register_with_telemetry<'life0, 'life1, 'life2, 'life3, 'async_trait>(
        &'life0 self,
        ctx: &'life1 SessionContext,
        table_name: &'life2 str,
        telemetry: Option<&'life3 Arc<TermTelemetry>>,
    ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait,
             'life2: 'async_trait,
             'life3: 'async_trait;
    fn schema(&self) -> Option<&Arc<Schema>>;
    fn description(&self) -> String;

    // Provided method
    fn register<'life0, 'life1, 'life2, 'async_trait>(
        &'life0 self,
        ctx: &'life1 SessionContext,
        table_name: &'life2 str,
    ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait,
             'life2: 'async_trait { ... }
}

Expand description

A data source that can be registered with a DataFusion context.

This trait defines the interface for all data sources in the Term library. Implementations should handle schema inference, compression detection, and efficient data loading.

§Examples

use term_guard::sources::{DataSource, CsvSource};

let source = CsvSource::new("data/users.csv")?;
let ctx = SessionContext::new();
source.register(&ctx, "users").await?;