使用指南：Rust 中的 DuckDB 绑定 - `duckdb-rs`

duckdb-rs 是一个旨在提供舒适 Rust 风格接口以使用 DuckDB 数据库的库。它模仿了 rusqlite 的接口设计，并且从 rusqlie 初始代码中派生而来，目标是提供类似于 SQLite 的 API 体验，但专用于 DuckDB。

1. 项目目录结构及介绍

该仓库遵循标准的 Rust 项目布局：

• root
  • Cargo.toml: 项目的主要配置文件，定义依赖项、版本和构建配置。
  • src
    • lib.rs: 主要库代码入口，包含了与 DuckDB 交互的核心逻辑。
    • 其他 rs 文件: 可能包括特定功能或模块的实现文件。
  • CONTRIBUTING.md: 贡献指南，指导如何参与项目贡献。
  • LICENSE: 许可协议文件，说明软件使用的 MIT 协议。
  • README.md: 项目快速入门和概览信息。
  • gitattributes, gitignore, gitmodules: 版本控制相关的配置文件。
  • Makefile: 提供了一些便捷的构建和测试命令。
  • rustfmt.toml: Rust 格式化工具的配置文件，确保代码风格一致。

2. 项目启动文件介绍

虽然严格意义上 duckdb-rs 作为一个库并不直接拥有“启动文件”，但在用户应用中，主要通过引入该库并在 main.rs 或应用程序的主入口文件来开始使用。示例性的启动过程通常包括以下步骤：

fn main() {
    let conn = duckdb::Connection::open_in_memory().expect("Failed to open in-memory DB");
    conn.execute("CREATE TABLE ...").expect("Table creation failed");
    // 接下来的数据库操作...
}

通过在您的项目中引入 duckdb-rs 并调用相应的功能来启动与数据库的交互。

3. 项目的配置文件介绍

duckdb-rs 直接使用环境变量（如 DUCKDB_LIB_DIR, DUCKDB_INCLUDE_DIR）以及 Cargo 特性（如 bundled）进行配置，而非传统意义上的单独配置文件。这意味着配置分布在如下几个地方：

• Cargo.toml: 用于指定依赖版本和可能的特性开启，例如启用 bundled 特性来使项目编译时自带 DuckDB 库。
• 环境变量: 控制 DuckDB 库的查找路径和编译选项，对于自定义编译路径或版本非常重要。
• 源码中的用法: 在实际使用过程中，通过设置连接参数或者 SQL 查询来间接配置数据库的行为。

总之，尽管没有直接的 YAML 或 JSON 配置文件，duckdb-rs 通过灵活的环境配置和 Cargo 层面的特性管理来适应不同的开发需求和环境配置。开发者需根据实际情况调整这些间接的配置元素来满足项目需求。