SELECT coalesce(
               (SELECT sha256_concat_hex(v)
                       OVER (ORDER BY v ROWS
                           BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING)
                FROM tbl
                LIMIT 1),
               sha256_hex('')
       );

请注意，窗口函数仅在 SQLite 3.25 及以后版本中可用，因此至少目前必须使用捆绑的 SQLite 版本。

use sqlite_hashes::{register_hash_functions, rusqlite::Connection};

let db = Connection::open_in_memory().unwrap();
register_hash_functions( & db).unwrap();

// Pre-populate the DB with some data. Note that the b values are not alphabetical.
db.execute_batch("
    CREATE TABLE tbl(id INTEGER PRIMARY KEY, v TEXT);
    INSERT INTO tbl VALUES (1, 'bbb'), (2, 'ccc'), (3, 'aaa');
  ").unwrap();

let sql = "SELECT sha256_concat_hex(v) OVER (
    ORDER BY v ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING)
    FROM tbl LIMIT 1;";
let hash: String = db.query_row_and_then( & sql, [], | r| r.get(0)).unwrap();
assert_eq!(hash, "FB84A45F6DF7D1D17036F939F1CFEB87339FF5DBDF411222F3762DD76779A287");

// The above window aggregation example is equivalent to this scalar hash:
let sql = "SELECT sha256_hex('aaabbbccc');";
let hash: String = db.query_row_and_then( & sql, [], | r| r.get(0)).unwrap();
assert_eq!(hash, "FB84A45F6DF7D1D17036F939F1CFEB87339FF5DBDF411222F3762DD76779A287");

与 SQLx 一起使用

要与 SQLx 一起使用，您需要从 SqliteConnection 获取原始句柄并将其传递给注册函数。

use rusqlite::Connection;
use sqlite_hashes::register_hash_functions;
use sqlx::sqlite::SqliteConnection;

async fn register_functions(sqlx_conn: &mut SqliteConnection) {
    // SAFETY: No query must be performed on `sqlx_conn` until `handle_lock` is dropped.
    let mut handle_lock = sqlx_conn.lock_handle().await.unwrap();
    let handle = handle_lock.as_raw_handle().as_ptr();

    // SAFETY: this is safe as long as handle_lock is valid.
    let rusqlite_conn = unsafe { Connection::from_handle(handle) }.unwrap();

    // Registration is attached to the connection, not to rusqlite_conn,
    // so it will be available for the entire lifetime of the `sqlx_conn`.
    // Registration will be automatically dropped when SqliteConnection is dropped.
    register_hash_functions(&rusqlite_conn).unwrap();
}

包特性

默认情况下，此包将编译所有功能。您可以选择只启用所需的功能，以减少编译时间和二进制文件大小。

[dependencies]
sqlite-hashes = { version = "0.7", default-features = false, features = ["hex", "window", "sha256"] }

• trace - 启用跟踪支持，记录所有函数调用及其参数
• hex - 启用十六进制字符串函数，如 *_hex() 和 *_concat_hex()（如果启用 aggregate）
• aggregate - 启用聚合函数，如 *_concat() 和 *_concat_hex()（如果启用 hex）
• window - 启用窗口函数支持（暗示 aggregate）
• md5 - 启用 MD5 哈希支持
• sha1 - 启用 SHA1 哈希支持
• sha224 - 启用 SHA224 哈希支持
• sha256 - 启用 SHA256 哈希支持
• sha384 - 启用 SHA384 哈希支持
• sha512 - 启用 SHA512 哈希支持
• fnv - 启用 FNV-1a 哈希支持
• xxhash - 启用 xxh32, xxh64, xxh3_64, xxh3_128 哈希支持

仅在构建可被直接加载到 sqlite3 可执行文件的 .so / .dylib / .dll 扩展文件时才应使用 loadable_extension 功能。

开发

• 该项目使用 just（make 的现代替代品）更容易开发。使用 cargo install just 安装它。
• 要获取可用命令列表，请运行 just。
• 要运行测试，请使用 just test。
• 在 git push 时，它将运行一些验证，包括 cargo fmt，cargo clippy 和 cargo test。使用 git push --no-verify 来跳过这些检查。

许可证

许可协议为以下之一

• Apache License, Version 2.0 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可协议 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)，您可选择其中之一。

贡献

除非您明确声明，否则根据 Apache-2.0 许可证定义的，您有意提交以包含在作品中的任何贡献，均将根据上述协议双重许可，不附加任何额外条款或条件。