Method register_listing_table

datafusion/core/src/execution/context/mod.rs:1814–1837

Registers a [`ListingTable`] that can assemble multiple files from locations in an [`ObjectStore`] instance into a single table. This method is `async` because it might need to resolve the schema. [`ObjectStore`]: object_store::ObjectStore

(
        &self,
        table_ref: impl Into<TableReference>,
        table_path: impl AsRef<str>,
        options: ListingOptions,
        provided_schema: Option<SchemaRef>,
        sql_definition:

    ///
    /// [`ObjectStore`]: object_store::ObjectStore
    pub async fn register_listing_table(
        &self,
        table_ref: impl Into<TableReference>,
        table_path: impl AsRef<str>,
        options: ListingOptions,
        provided_schema: Option<SchemaRef>,
        sql_definition: Option<String>,
    ) -> Result<()> {
        let table_ref = table_ref.into();
        let table_path =
            ListingTableUrl::parse(table_path)?.with_table_ref(table_ref.clone());
        let resolved_schema = match provided_schema {
            Some(s) => s,
            None => options.infer_schema(&self.state(), &table_path).await?,
        };
        let config = ListingTableConfig::new(table_path)
            .with_listing_options(options)
            .with_schema(resolved_schema);
        let table = ListingTable::try_new(config)?
            .with_definition(sql_definition)
            .with_cache(self.runtime_env().cache_manager.get_file_statistic_cache());
        self.register_table(table_ref, Arc::new(table))?;
        Ok(())
    }

    fn register_type_check<P: DataFilePaths>(
        &self,