# taibai-rust

**Repository Path**: coraldane/taibai-rust

## Basic Information

- **Project Name**: taibai-rust
- **Description**: 针对taibai数据库的rust驱动
- **Primary Language**: Rust
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# taibai-rust

`taibai-rust` 是 Taibai 自研列式数据库的异步 Rust 驱动。

## 功能

- tokio 异步 TCP 客户端
- 登录、登出、Ping、超时和错误处理
- SQL query / execute
- 文本结果与二进制列式结果解码
- 19 种 Taibai wire 数据类型
- 预处理语句、参数绑定、批量执行和关闭语句
- 事务 begin / commit / rollback
- flush
- 列式批量导入和 pipeline
- 变更订阅、变更事件接收和 consumer ack
- 连接池
- 游标占位 API

协议依据见 Taibai 服务端工程 `docs/taibai-rust-driver-spec.md`。

## 快速开始

```rust
use taibai_rust::{Client, ClientOptions};

#[tokio::main]
async fn main() -> taibai_rust::Result<()> {
    let mut client = Client::connect_with_options(ClientOptions::default()).await?;
    client.execute("CREATE DATABASE IF NOT EXISTS demo").await?;
    let rows = client.query("SHOW TABLES").await?;
    println!("{rows:?}");
    Ok(())
}
```

默认连接 `127.0.0.1:5151`，用户 `root`，密码 `taibai`，数据库 `main`。

## 验证

```powershell
cargo fmt
cargo test
```

本地集成测试需要先启动 Taibai 服务端。