跳到主要内容

简介

duckfn_statrs 是一个 DuckDB loadable extension, 把 Rust 统计计算库 statrs 的全部能力包装成可直接在 SQL 里调用的 函数。它在 sr_ 前缀下注册了 511 个函数:

类别类型数量示例
描述统计量聚合32sr_mean、sr_median、sr_variance、sr_covariance
连续分布标量272sr_normal_pdf、sr_gamma_cdf、sr_beta_quantile
离散分布标量110sr_poisson_pmf、sr_binomial_cdf、sr_geometric_quantile
特殊函数标量32sr_gamma、sr_erf、sr_ln_choose
常量标量7sr_ln_pi、sr_sqrt_2pi、sr_euler_mascheroni
随机抽样标量30sr_sample_normal、sr_sample_beta
密度估计标量2sr_kde_pdf、sr_knn_pdf
信号生成标量6sr_gen_sinusoidal、sr_gen_square
假设检验标量10sr_ttest_onesample、sr_ks_twosample、sr_chisquare
多元分布标量10sr_multivariate_normal_pdf、sr_dirichlet_pdf

计算全部交给 statrs,本扩展不重新实现任何统计公式。描述统计量是聚合函数,分布 / 抽样 / 特殊函数 / 常量是标量函数(逐行求值)。

就地试试——这个块会在你的浏览器里真跑(站点自动预加载扩展):

SELECT g, sr_mean(x) AS mean, sr_std_dev(x) AS std_dev
FROM (VALUES (1, 1.0), (1, 2.0), (1, 3.0), (2, 10.0), (2, 20.0)) t(g, x)
GROUP BY g ORDER BY g;
SELECT x, sr_normal_pdf(x, 0.0, 1.0) AS pdf, sr_normal_cdf(x, 0.0, 1.0) AS cdf
FROM (VALUES (-1.96::DOUBLE), (0.0), (1.96)) t(x);

NULL 语义​

整条规则一句话说完:statrs 算不出的就是 SQL NULL,NULL 输入也永远不会悄悄变成一个数。 具体拆开:NULL 行不进聚合(SQL 聚合惯例,与 DuckDB 自带的 mean/stddev 一致);statrs 对空组、 单值的样本方差、越界的 tau、几何/调和平均里的负数返回的 NAN,统一折成 NULL。参数存在但 非法(std_dev <= 0、概率不在 [0, 1] 内)是调用写错了,报查询错误,而不是被静默折成空。

接下来去哪​