Skip to main content

insert_record_batch_direct

Function insert_record_batch_direct 

Source
pub fn insert_record_batch_direct(
    conn: &Connection,
    dest_table: &str,
    batch: RecordBatch,
    options: InsertOptions,
) -> Result<()>
Expand description

Insert a single RecordBatch using the direct chdb_insert_arrow_array FFI when available, falling back to register + SQL + unregister otherwise.

Unlike insert_record_batch, no temporary stream_name is required on the direct path. This is the recommended entry point for single-batch ingest.

ยงExamples

use std::sync::Arc;
use arrow::array::{Int64Array, RecordBatch};
use arrow::datatypes::{DataType, Field, Schema};
use chdb_rust::arrow_insert::insert_record_batch_direct;
use chdb_rust::InsertOptions;
use chdb_rust::connection::Connection;

let conn = Connection::open_in_memory()?;
conn.query(
    "CREATE TABLE metrics (id Int64) ENGINE=MergeTree ORDER BY id",
    chdb_rust::format::OutputFormat::TabSeparated,
)?;

let batch = RecordBatch::try_new(
    Arc::new(Schema::new(vec![Field::new("id", DataType::Int64, false)])),
    vec![Arc::new(Int64Array::from(vec![1i64, 2, 3]))],
)
.map_err(|e| chdb_rust::error::Error::QueryError(e.to_string()))?;

insert_record_batch_direct(&conn, "metrics", batch, InsertOptions::default_bulk())?;