DB Browser for SQLite 插件开发20 行代码写出你的第一个扩展函数【免费下载链接】sqlitebrowserOfficial home of the DB Browser for SQLite (DB4S) project. Previously known as SQLite Database Browser and Database Browser for SQLite. Website at:项目地址: https://gitcode.com/gh_mirrors/sq/sqlitebrowserDB Browser for SQLite 是一款广泛使用的图形化 SQLite 数据库管理工具它的 DB Browser for SQLite 插件系统能让你用几十行 C 代码给 SQL 加上新函数。本文带你从零写完、编译并加载一个可用的扩展。为什么 SQL 缺函数要靠插件来补你在写查询时想在结果列里算个pow(salary, 2)却发现 SQLite 的内置函数里没有幂运算、没有三角函数也没法在会话里临时贴一行代码进去。最靠谱的路径不是等版本更新而是自己写一个扩展库加载进数据库连接后直接在 SQL 里调用。DB Browser for SQLite 的插件系统正是为此设计的。它基于 SQLite 原生的可加载扩展机制即sqlite3_load_extension接口把编译共享库 加载这件事简化成了菜单点几下扩展列表还和图形界面的设置系统打通。DB Browser for SQLite 插件生态全景一张图看清分层与类型插件系统可以拆成三层GUI 层负责在 Preferences 里管理扩展文件列表加载层在DBBrowserDB::loadExtension里临时打开动态加载开关、调用sqlite3_load_extension加载完再按配置恢复状态最底层的 SQLite 核心在加载共享库时回调你代码里的sqlite3_extension_init入口函数注册就发生在这里。也就是说一个扩展加载后可以注册四类能力标量函数一进一出的转换如math_pow、聚合函数stdev、variance这类分组统计、虚拟表把自定义数据源注册成一张表、排序规则自定义字符串比较与排序方式。仓库在 src/extensions/ 下自带了格式转换与数学/字符串函数两个官方示例可以直接当模板抄。SQLite 自定义函数怎么写20 行数学扩展示例简单来说自定义函数 一个 C 回调 一行注册。回调里用sqlite3_value**数组读参数按类型调sqlite3_value_double/sqlite3_value_text/sqlite3_value_blob配sqlite3_value_bytes拿长度再用sqlite3_result_*系列把结果写回两端就齐了。下面是math_pow(base, exp)的完整函数体含头文件共 11 行#include math.h #include sqlite3ext.h SQLITE_EXTENSION_INIT1 // math_pow(base, exp)NULL 进 NULL 出否则读参数、计算并写回 static void math_pow(sqlite3_context *ctx, int argc, sqlite3_value **argv) { if (sqlite3_value_type(argv[0]) SQLITE_NULL) sqlite3_result_null(ctx); else sqlite3_result_double(ctx, pow(sqlite3_value_double(argv[0]), sqlite3_value_double(argv[1]))); }重点看 NULL 分支不处理它NULL 列值的行为就是未定义。然后写入口函数注册一下sqlite3_create_function的第三个参数是形参个数SQLITE_DETERMINISTIC标志告诉优化器相同输入必得相同输出方便查询优化// SQLite 加载共享库时调用这个入口只需注册函数 int sqlite3_extension_init(sqlite3 *db, char **err, const sqlite3_api_routines *api) { SQLITE_EXTENSION_INIT2(api); sqlite3_create_function(db, math_pow, 2, SQLITE_UTF8 | SQLITE_DETERMINISTIC, NULL, math_pow, NULL, NULL); return SQLITE_OK; }两段代码加起来不到 20 行之后 SQL 里写SELECT math_pow(2, 10)就能用。进阶格式转换Base64 插件的实现思路二进制数据是内置函数的盲区仓库自带的 formats 扩展就注册了toBase64/unBase64做编码解码。核心思路三步先用sqlite3_value_type判断输入是 BLOB 还是 TEXT再取出字节调编解码核心函数最后决定结果以什么类型返回。简化后的关键片段如下case SQLITE_BLOB: case SQLITE_TEXT: { const char *data (const char *)sqlite3_value_text(argv[0]); // 取输入字节 int len sqlite3_value_bytes(argv[0]); decodeBase64(out, outLen, data, len); // 调解码核心 // 解码结果若为合法 UTF-8 则返回 TEXT否则返回 BLOB sqlite3_result_blob(ctx, out, outLen, freeResult); }unBase64里有个值得借鉴的细节解码后先探测结果是不是合法 UTF-8是就当文本返回否则按 BLOB 返回图形界面就能直接友好渲染。至于 Plist 解析plistToJson思路完全相同——先查bplist00魔数头不是 Plist 就原样返回原值不报错。三步搞定扩展编译各平台命令、GUI 加载与验证 编译就是把它打成位置无关的共享库三个平台各一行# Linux gcc -fPIC -lm -shared math_pow.c -o libmath_pow.so # macOS gcc -fno-common -dynamiclib math_pow.c -o libmath_pow.dylib # WindowsMinGW gcc -shared -o math_pow.dll math_pow.c注意 Linux 要带-lm链接数学库如果sqlite3ext.h不在默认搜索路径补一个-I即可。加载有两条路。临时加载打开数据库后在 Database 菜单选 Load Extension...选中刚编译的文件当次会话立即可用。持久加载Preferences → Extensions 里点 Add Extension 添加路径写进配置项extensions/list之后每次打开数据库都由loadExtensionsFromSettings自动加载。加载完跑三条语句自检SELECT math_pow(2, 10);应返回 1024.0SELECT math_pow(9, 0.5);应返回 3.0SELECT math_pow(NULL, 2);应返回 NULL。三条全对说明扩展链路完全打通。✅扩展开发避坑清单 内存传给sqlite3_result_*的缓冲区必须由 SQLite 释放——用SQLITE_TRANSIENT或自定义析构回调别直接返回栈指针。NULL先查sqlite3_value_type再取值得参数漏掉 NULL 分支时行为未定义。线程安全扩展函数可能被并发调用函数内别存可变的全局状态。错误隔离解析或计算失败时返回原值或sqlite3_result_error报错不要静默返回脏数据把整条查询带崩。命名冲突同名注册会覆盖已有函数给函数名加math_这类前缀避免踩到内置函数。安全开关默认配置下 GUI 加载完扩展会关闭动态加载别人无法再从 SQL 里调用load_extension()共享机器上别随意打开enable_load_extension。打开终端把第一个扩展库编译出来让math_pow出现在你的查询结果里。【免费下载链接】sqlitebrowserOfficial home of the DB Browser for SQLite (DB4S) project. Previously known as SQLite Database Browser and Database Browser for SQLite. Website at:项目地址: https://gitcode.com/gh_mirrors/sq/sqlitebrowser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
