Apache DataFusion SQL Query Engine
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: See the NOTICE file distributed with this work for additional information regarding copyright ownership
// SPDX-FileContributor: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements
//! See `main.rs` for how to run it.
use datafusion::error::Result;
use datafusion::prelude::*;
use datafusion_examples::utils::datasets::ExampleDataset;
/// This example demonstrates executing a simple query against an Arrow data source (CSV) and
/// fetching results with streaming aggregation and streaming window
pub async fn csv_sql_streaming() -> Result<()> {
// create local execution context
let ctx = SessionContext::new();
let dataset = ExampleDataset::Cars;
let csv_path = dataset.path();
// Register a table source and tell DataFusion the file is ordered by `car ASC`.
// Note it is the responsibility of the user to make sure
// that file indeed satisfies this condition or else incorrect answers may be produced.
let asc = true;
let nulls_first = true;
let sort_expr = vec![col("car").sort(asc, nulls_first)];
// register csv file with the execution context
ctx.register_csv(
"ordered_table",
csv_path.to_str().unwrap(),
CsvReadOptions::new().file_sort_order(vec![sort_expr]),
)
.await?;
// execute the query
// Following query can be executed with unbounded sources because group by expressions (e.g car) is
// already ordered at the source.
//
// Unbounded sources means that if the input came from a "never ending" source (such as a FIFO
// file on unix) the query could produce results incrementally as data was read.
let df = ctx
.sql(
"SELECT car, MIN(speed), MAX(speed) \
FROM ordered_table \
GROUP BY car",
)
.await?;
df.show().await?;
// execute the query
// Following query can be executed with unbounded sources because window executor can calculate
// its result in streaming fashion, because its required ordering is already satisfied at the source.
let df = ctx
.sql(
"SELECT car, SUM(speed) OVER(ORDER BY car ASC) \
FROM ordered_table",
)
.await?;
df.show().await?;
Ok(())
}