大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:percentile_approx_weight

· 52CE 我爱测

计算指定百分位数的加权近似值。百分位数参数 p 可以是一个值或一个数组。 是 的加权版本,允许用户为每个输入值指定一个权重(一个常量值或数值列)。

percentile_approx_weight

计算指定百分位数的加权近似值。百分位数参数 p 可以是一个值或一个数组。percentile_approx_weight 是 PERCENTILE_APPROX 的加权版本,允许用户为每个输入值指定一个权重(一个常量值或数值列)。

此函数使用固定大小的内存,因此对于高基数的列可以使用更少的内存。它也可以用于计算诸如 tp99 之类的统计数据。

语法

DOUBLE PERCENTILE_APPROX_WEIGHT(expr, BIGINT weight, DOUBLE|ARRAY<DOUBLE> p[, DOUBLE compression])
  • expr: 要计算分位数的列。
  • p : 支持的数据类型为 DOUBLE,p 的值介于 0 到 1 之间; 数组类型ARRAY<DOUBLE>, 数组每个值介于0 到 1之间。 例如,0.99 表示第 99 个百分位数。
  • weight : 权重列。必须是一个正的常量数或列。
  • compression : (可选)压缩比。范围:[2048, 10000]。值越大,精度越高,内存消耗越大,计算时间越长。如果未指定此参数或值超出 [2048, 10000] 的范围,则使用默认值 10000。

示例

CREATE TABLE t1 (
    c1 int,
    c2 double,
    c3 tinyint,
    c4 int,
    c5 bigint,
    c6 largeint,
    c7 string,
    c8 double,
    c9 date,
    c10 datetime,
    c11 array<int>,
    c12 map<double, double>,
    c13 struct<a bigint, b double>
    )
DUPLICATE KEY(c1)
DISTRIBUTED BY HASH(c1)
BUCKETS 1
PROPERTIES ("replication_num" = "1");
insert into t1 
    select generate_series, generate_series,  11, 111, 1111, 11111, "111111", 1.1, "2024-09-01", "2024-09-01 18:00:00", [1, 2, 3], map(1, 5.5), row(100, 100)
    from table(generate_series(1, 50000, 3));
-- 使用常量值作为权重
mysql> select percentile_approx_weighted(c1, 1, 0.9) from t1;
+----------------------------------------+
| percentile_approx_weighted(c1, 1, 0.9) |
+----------------------------------------+
|                          45000.3984375 |
+----------------------------------------+
1 row in set (0.07 sec)
-- 使用数值列作为权重
mysql> select percentile_approx_weighted(c2, c1, 0.5) from t1;
+-----------------------------------------+
| percentile_approx_weighted(c2, c1, 0.5) |
+-----------------------------------------+
|                          35355.97265625 |
+-----------------------------------------+
1 row in set (0.07 sec)
-- 使用权重和压缩比计算分位数
mysql> select percentile_approx_weighted(c2, c1, 0.5, 10000) from t1;
+------------------------------------------------+
| percentile_approx_weighted(c2, c1, 0.5, 10000) |
+------------------------------------------------+
|                                 35355.97265625 |
+------------------------------------------------+
1 row in set (0.09 sec)

mysql> select percentile_approx_weighted(c2, c1, [0.1, 0.5, 0.9], 10000) from t1;
+------------------------------------------------------------+
| percentile_approx_weighted(c2, c1, [0.1, 0.5, 0.9], 10000) |
+------------------------------------------------------------+
| [15811.6708984375,35355.97265625,47435.01171875]           |
+------------------------------------------------------------+
1 row in set (0.03 sec)

关键词

PERCENTILE_APPROX_WEIGHT,PERCENTILE_APPROX,PERCENTILE,APPROX

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。