Crate llkv_sql 

SQL interface for LLKV.

This crate provides the SqlEngine, which parses SQL statements and executes them using the LLKV runtime. It serves as the primary user-facing interface for interacting with LLKV databases.

SQL String → sqlparser → AST → Plan → Runtime → Storage

The SQL engine:

1. Parses SQL using sqlparser
2. Converts AST to execution plans
3. Delegates to llkv-runtime for execution
4. Returns results as Arrow RecordBatch instances or row counts

Transactions

By default, each statement executes in its own auto-commit transaction. Use explicit transaction control for multi-statement transactions:

Type System

SQL types are mapped to Arrow data types (the following is a non-exhaustive list):

• INT, INTEGER, BIGINT → Int64
• FLOAT, DOUBLE, REAL → Float64
• TEXT, VARCHAR → Utf8
• DATE → Date32

Re-exports

pub use sql_types::SqlTypeFamily;

pub use sql_types::classify_sql_data_type;

Modules

sql_types

SQL data type classification helpers shared across SQL-facing crates.

tpch

Structs

PreparedStatement

SelectExecution

Streaming execution handle for SELECT queries.

SqlEngine

Enums

RuntimeStatementResult

SqlParamValue

StatementExpectation

TransactionKind

Transaction kind enum representing transaction control operations.

Traits

ObjectNameExt

Extension methods for working with ObjectName.

OrderCreateTablesExt

Order CREATE TABLE statements such that referenced tables appear before dependents.

TableConstraintExt

Extension methods for normalizing TableConstraint instances.

Functions

clear_pending_statement_expectations

register_statement_expectation

Type Aliases

SqlResult