sqlite3_ext

在Rust中创建SQLite可加载扩展。API的设计理念是渐进式增强：所有使用SQLite功能的调用都返回一个Result，当宿主版本的SQLite不支持所询问的功能时，返回Err。

早期版本警告

这个crate是预1.0版本，API允许自由更改。特别是，如果发现一个安全API是不安全的，它将被更改。一旦crate达到1.0版本，API将受到语义版本控制。

作为一个预1.0版本、年轻的crate，可能存在尚未发现的bug。crate附带了一个适度覆盖所有功能（目前超过100个测试）的测试套件。

Crate文档适度覆盖，仓库中有示例扩展可以作为指南。还可以查看根目录下的“test”文件夹中的集成测试。

功能

• 类似于Rusqlite的查询接口。
• 应用程序定义的标量和聚合函数，以及排序序列。
• 比其他任何已发布的Rust crate更全面的虚拟表实现，支持所有SQLite虚拟表方法。
• 支持SQLite最新的功能，最高到版本3.38.5。

crate功能

• static - 这个crate的消费者不是一个SQLite可加载扩展。SQLite API将由链接器提供。为了避免链接错误，sqlite3_ext禁用了3.6.8之后添加的所有API。
• static_modern - 与static相同，但sqlite3_ext不会禁用任何API。如果链接的SQLite版本低于sqlite3_ext支持的版本，这将导致链接错误。
• bundled - 与static_modern相同，但使用从libsqlite3-sys捆绑的SQLite版本（而不是系统版本）。这是为Rust程序构建静态可加载扩展的推荐方式。
• with_rusqlite - 添加了对将静态链接的扩展注册到Rusqlite连接对象的支持。请参阅此测试的示例。

编译模式

sqlite3_ext支持三种编译模式

• 作为一个可加载的扩展。您的crate类型为crate-type = [ "cdylib" ]，并作为SQLite的可加载扩展被加载到另一个进程中。
  • SQLite方法在运行时由SQLite提供。
• 作为一个静态链接的扩展。您的crate类型为crate-type = [ "staticlib" ]，并将其静态链接到另一个程序中。
  • 链接器提供SQLite方法。
• 作为一个Rust库。您的crate具有任何类型，并像其他crate一样使用sqlite3_ext。
  • 您负责提供SQLite（例如通过Rusqlite）。

crate配置

• 默认情况下，crate被配置为动态加载SQLite。
• 使用功能static，crate能够静态链接到Rust或C程序。这非常兼容，但会禁用许多SQLite功能。
• 使用功能static_modern，crate能够静态链接到Rust或C程序。这要求系统的SQLite版本至少与sqlite3_ext支持的版本相同，否则将出现链接错误。

测试配置

使用现代SQLite运行的测试

• Cargo.toml中所有具有crate功能static的测试。
• Cargo.toml中所有具有crate功能static_modern的测试。

待办事项

• 针对SQLite 3.6.8运行测试。

支持接口

以下是一个兼容性图表，显示sqlite3_ext目前覆盖了SQLite API的哪些部分。图标

• ✅ - 此API通过sqlite3_ext中的API完全公开
• ❕ - 此API通过unsafe ffi提供，但sqlite3_ext中没有计划为它创建API。