timescaledb_toolkit
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
timescaledb_toolkit | 1.23.0 | TIME | Timescale | Rust |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 1010 | timescaledb_toolkit | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | timescaledb timeseries pg_stl first_last_agg extra_window_functions quantile tdigest topn tablefunc |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 1.23.0 | 1817161514 | timescaledb_toolkit | - |
| RPM | PIGSTY | 1.23.0 | 1817161514 | timescaledb-toolkit_$v | - |
| DEB | PIGSTY | 1.23.0 | 1817161514 | postgresql-$v-timescaledb-toolkit | - |
构建
您可以使用 pig build 命令构建 timescaledb_toolkit 扩展的 RPM / DEB 包:
安装
您可以直接安装 timescaledb_toolkit 扩展包的预置二进制包,首先确保 PGDG 和 PIGSTY 仓库已经添加并启用:
使用 pig 或者是 apt/yum/dnf 安装扩展:
创建扩展:
用法
来源:documentation index、v1.23.0 release、Changelog
TimescaleDB Toolkit 提供了一系列专用于时序数据分析的函数,采用两步聚合模式。大多数函数会先创建中间表示,再通过访问器函数进行查询,从而实现高效复用和多维分析。
近似分析
HyperLogLog - 基数估算
基于概率的去重计数,支持可配置精度,适用于高基数数据集。
T-Digest - 分位数近似
高精度百分位估算,针对尾部分位数(P95、P99)进行了优化。
UddSketch - 有界误差分位数
带有最大相对误差保证的分位数估算。
计数器分析
计数器聚合 - 单调递增指标
处理单调递增的计数器,自动检测重置。
仪表聚合 - 波动指标
用于分析上下波动的指标(如温度、内存使用量)。
时间加权分析
时间加权平均
处理不规则采样数据,支持插值方法(LOCF 末次观测值保持、Linear 线性插值)。
数据可视化
LTTB 降采样
在保持视觉相似性的前提下对时序数据进行降采样,适用于图表展示。
ASAP 平滑
通过降噪生成易于阅读的图表,同时保留趋势特征。
统计分析
统计聚合
提供全面的统计分析能力,支持一维和二维回归分析。
Timevector 数据类型
用于时序操作的高效中间表示。
集成模式
连续聚合支持
大多数 Toolkit 函数可与 TimescaleDB 连续聚合无缝配合使用:
两步分析模式
存储中间聚合结果,支持多维度分析复用:
所有位于 experimental 模式(toolkit_experimental)中的函数可能会在版本间发生变化。生产环境中如需 API 稳定性保证,请使用稳定版函数。
版本说明
timescaledb_toolkit 1.23.0 有两项行为变化需要在测试中留意:max_n、max_n_by、min_n 和 min_n_by 在 empty streams 上返回空结果而不是报错;1D aggregations 现在会在值可能丢失 53-bit precision 时报错,而不是静默返回错误数据。该版本还将 time_weight 及其 rollup 标记为 parallel-unsafe,升级到 pgrx 0.18,并修复 ASAP smoothing sortedness checks。