pg_statkit

概览

Release Cargo/CI support PostgreSQL 13-17 with pgrx 0.18.1; no PG18 feature. This is statistical computation, not server monitoring.

版本

构建

您可以使用 pig build 命令构建 pg_statkit 扩展的 RPM / DEB 包：

pig build pkg pg_statkit         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_statkit 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

pig install pg_statkit;          # 当前活跃 PG 版本安装

pig ext install -y pg_statkit -v 17  # PG 17
pig ext install -y pg_statkit -v 16  # PG 16
pig ext install -y pg_statkit -v 15  # PG 15
pig ext install -y pg_statkit -v 14  # PG 14

dnf install -y pg_statkit_17       # PG 17
dnf install -y pg_statkit_16       # PG 16
dnf install -y pg_statkit_15       # PG 15
dnf install -y pg_statkit_14       # PG 14

apt install -y postgresql-17-pg-statkit   # PG 17
apt install -y postgresql-16-pg-statkit   # PG 16
apt install -y postgresql-15-pg-statkit   # PG 15
apt install -y postgresql-14-pg-statkit   # PG 14

创建扩展：

CREATE EXTENSION pg_statkit;

用法

来源：

• 官方 README
• 扩展控制文件
• pgrx 清单

pg_statkit 在 PostgreSQL 数组上提供描述统计与临床效应量函数，无需把源数据导出到独立分析进程。

启用

1.1.0 版本通过 pgrx 0.18.1 构建并测试 PostgreSQL 13–17。安装匹配的原生构件后，以超级用户创建不可迁移、非 trusted 的扩展：

CREATE EXTENSION pg_statkit;

它不要求预加载或重启。

描述统计

函数接收 double precision[]；应显式转换数组字面量，因为小数字面量默认会形成 numeric[]。

SELECT statkit_mean('{1,2,3,4,5}'::float8[]);
SELECT statkit_median('{1,2,3,4,5}'::float8[]);
SELECT statkit_iqr('{1,2,3,4,5}'::float8[]);
SELECT statkit_percentile('{1,2,3,4,5}'::float8[], 40);

SELECT patient_id,
       statkit_median(array_agg(value::float8)) AS median_value
FROM measurements
GROUP BY patient_id;

函数面还包括 variance、population/sample standard deviation、MAD、coefficient of variation 与 standard error。

效应量与解释

statkit_risk_difference、statkit_risk_ratio 与 statkit_odds_ratio 用四个 bigint count 表示 2×2 表。statkit_cohens_d、statkit_hedges_g 与 statkit_glass_delta 接收两组 sample。

SELECT statkit_odds_ratio(a => 8, b => 2, c => 2, d => 8);

SELECT statkit_cohens_d(
  array_agg(value::float8) FILTER (WHERE arm = 'treatment'),
  array_agg(value::float8) FILTER (WHERE arm = 'control')
)
FROM trial;

若任一单元格为零，odds-ratio function 会应用 0.5 修正。未定义输入返回 NULL。1.1.0 不提供 confidence interval、hypothesis test 或 assumption check；研究结论需要这些能力时，应使用完整统计软件包。