安装与加载
前置条件
- DuckDB 1.3 或更新版本(CLI、App 或任何语言客户端)。
从社区仓库安装
扩展注册进 DuckDB 社区扩展 之后, 安装只需两条语句:
INSTALL duckfn_statrs FROM community;
LOAD duckfn_statrs;
不需要额外参数——社区构建的产物已签名,并与你的 DuckDB 版本严格匹配。
从 GitHub Release 安装
如果社区路线尚不可用,从 Releases 页面下载对应平台的
产物,命名是 duckfn_statrs-<平台>.duckdb_extension —— 加载之前必须先改名成 duckfn_statrs.duckdb_extension:
LOAD 收的是扩展名或本地路径,它不会去下载 URL(下载那条路是 INSTALL '<url>'),而入口点符号由文件名决定,
直接用 Release 里的名字会报 did not contain function "duckfn_statrs-windows_amd64_init_c_api":
curl -LO https://github.com/shijianjs/duckfn-statrs/releases/latest/download/duckfn_statrs-windows_amd64.duckdb_extension
mv duckfn_statrs-windows_amd64.duckdb_extension duckfn_statrs.duckdb_extension
duckdb -unsigned -c "LOAD './duckfn_statrs.duckdb_extension';"
备注
Release 产物没有 DuckDB 分发密钥的签名,启动 CLI 时需要加 -unsigned 参数:duckdb -unsigned。
上面的社区路线没有这个限制。
验证安装
SELECT function_name, function_type
FROM duckdb_functions()
WHERE function_name LIKE 'sr_%'
ORDER BY function_name;
-- 511 行
第一批查询
描述统计量是聚合函数——传入一列,每个分组一个值:
SELECT g, sr_mean(x) AS mean, sr_std_dev(x) AS std_dev, sr_median(x) AS median
FROM (VALUES (1, 1.0), (1, 2.0), (1, 3.0), (2, 10.0), (2, 20.0), (2, NULL)) t(g, x)
GROUP BY g
ORDER BY g;
分布函数是标量——逐行求值:
SELECT x, sr_normal_cdf(x, 0.0, 1.0) AS cdf, sr_normal_pdf(x, 0.0, 1.0) AS pdf
FROM (VALUES (-1.96::DOUBLE), (0.0), (1.96)) t(x);
参数非法时报错清晰明确:
SELECT sr_normal_pdf(0.0, 0.0, -1.0); -- 报错:sr_normal_pdf: Standard deviation is NaN, zero or less than zero
NULL 行为
- NULL 输入行不进聚合(标准 SQL 惯例)。
- statrs 算不出结果时(空组、样本不足、参数越界),返回 SQL NULL——绝不是 NAN。
- 参数存在但非法(如
std_dev <= 0)报查询错误。
-- statrs 算不出单值的样本方差:结果是 NULL 而不是 0。
SELECT grp, sr_variance(x) AS variance
FROM (VALUES ('two', 1.5::DOUBLE), ('two', 2.5), ('one', NULL::DOUBLE), ('one', 3.0)) t(grp, x)
GROUP BY grp
ORDER BY grp;