StarRocks 数学函数 SIN 详解语法、返回值与向量化实现原理【免费下载链接】starrocksThe worlds fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocks本篇技术指南围绕 StarRocks 内置数学函数SIN展开说明其在 SQL 查询中计算弧度制参数正弦值的用法包括语法、参数类型、返回值与可运行的查询示例。文章同时结合当前仓库中 BEBackend侧的函数注册与向量化实现源码剖析SIN在 StarRocks 内部如何被解析、编译并高效执行帮助读者既会用它做数值计算也能理解其底层原理。相关文档原文位于 docs/en/sql-reference/sql-functions/math-functions/sin.md。函数功能概述SIN是 StarRocks 提供的三角函数之一用于计算输入参数x的正弦值sine。需要特别注意的是参数x必须以弧度radian为单位而非角度degree。例如SIN(0)返回0SIN(pi()/2)返回1。在 StarRocks 的 SQL 函数体系中SIN属于数学函数Math Function被归入标量Scalar函数类别可直接出现在SELECT投影列、WHERE过滤条件以及表达式中与COS、TAN、ASIN、SINH等三角函数并列这些函数在 BE 源码 be/src/exprs/math_functions.cpp 中集中实现。语法SIN(x);函数名不区分大小写即sin(x)、Sin(x)与SIN(x)等价。参数说明参数说明x待计算正弦值的数值支持 DOUBLE 数据类型。传入其他数值类型如INT、BIGINT、DECIMAL时StarRocks 会依据隐式类型转换规则将其转换为DOUBLE后参与计算。从函数注册表看SIN的参数类型被固定声明为DOUBLE。在 FE 侧的函数签名定义gensrc/script/functions.py中其声明为[10050, sin, True, False, DOUBLE, [DOUBLE], MathFunctions::sin],各字段的含义如下10050函数在 StarRocks 内置函数表中的函数 IDsin函数名第 3 个布尔值True表示支持向量化执行Vectorized Execution第 4 个布尔值False表示非聚合类函数第一个DOUBLE返回值类型为DOUBLE[DOUBLE]入参类型列表仅接受一个DOUBLE类型参数MathFunctions::sin映射到 BE 端 C 实现入口MathFunctions::sin。也就是说SIN在 StarRocks 中是一个单入参、双精度、支持向量化的纯标量函数这决定了它既能在行式处理中工作也能在批量列式计算中被高效执行。返回值返回值为DOUBLE数据类型数值范围落在闭区间[-1, 1]内正弦函数的数学值域。当入参为NULL时返回NULL遵循 SQL 标准的三值逻辑当入参为NaN非数值或Infinity无穷大时计算得到的结果为NaN。使用示例1. 文档中的基础示例原文给出了最直接的常量计算示例mysql select sin(3.14); ----------------------- | sin(3.14) | ----------------------- | 0.0015926529164868282 | ----------------------- 1 row in set (0.21 sec)3.14是圆周率π的两位小数近似值因此SIN(3.14)的结果约等于SIN(π) 0即0.0015926529164868282这样一个接近零的极小值。这恰好说明了弧度制下该函数的数值行为SIN的参数是弧度而不是角度。2. 结合内置常量与四则运算StarRocks 内置pi()函数返回DOUBLE类型的圆周率常量实现在 be/src/exprs/math_functions.cpp返回M_PI可写出更精确的示例mysql select sin(pi()); ---------------------- | sin(pi()) | ---------------------- | 1.2246467991473532e-16 | ---------------------- 1 row in set (0.10 sec) mysql select sin(pi()/2); ------------- | sin(pi()/2) | ------------- | 1 | ------------- 1 row in set (0.10 sec)SIN(pi())的结果1.2246467991473532e-16是浮点数表示π时产生的舍入误差数学上即为0而SIN(pi()/2)精确等于1是正弦函数的最大值点。3. 对列数据进行计算实际业务中SIN更常用于对表中某一列逐行计算mysql select angle, sin(angle) from sample_angles; --------------------------- | angle | sin(angle) | --------------------------- | 0 | 0 | | 1 | 0.8414709848078965 | | -1 | -0.8414709848078965 | --------------------------- 3 rows in set (0.05 sec)从结果可以看到SIN是奇函数SIN(-x) -SIN(x)且计算为**逐元素element-wise**进行可无缝嵌入SELECT、WHERE、ORDER BY等任意表达式位置-- 筛选正弦值大于 0.5 的行 SELECT angle FROM sample_angles WHERE sin(angle) 0.5; -- 用正弦值构造新的派生列 SELECT angle, sin(angle) * 100 AS normalized FROM sample_angles;底层实现向量化与 NaN 防护SIN在 BE 端的实现位于 be/src/exprs/math_functions.cpp对应头文件声明见 be/src/exprs/math_functions.hDEFINE_MATH_UNARY_WITH_OUTPUT_NAN_CHECK_FN_WITH_IMPL(sin, TYPE_DOUBLE, TYPE_DOUBLE, std::sin);这一行宏展开后完成三件事内核函数直接委托给 C 标准库的std::sin保证数值精度与标准库一致类型映射入参类型TYPE_DOUBLE、返回类型TYPE_DOUBLE与 FE 侧注册表 gensrc/script/functions.py 中声明的DOUBLE - DOUBLE完全对应输出 NaN 检查宏DEFINE_MATH_UNARY_WITH_OUTPUT_NAN_CHECK_FN定义见 be/src/exprs/math_functions.cpp将求值器包装为VectorizedOutputCheckUnaryFunctionsinImpl, NanCheck其中NanCheckbe/src/exprs/math_functions.cpp会在每个输出值上执行std::isnan(value)检查。这里的“向量化”是关键StarRocks 的表达式求值采用**批量列式vectorized**执行模型sin不再逐行调用函数而是对整列数据一次性送入VectorizedStrictUnaryFunction模板求值器通过 SIMD 友好的循环对一整个DoubleColumn计算正弦从而大幅摊薄函数调用开销。这正是 StarRocks 能在大数据量、高并发分析场景下保持亚秒级响应的重要基础之一。同理COS、TAN、ASIN、ACOS、SINH、COSH、TANH等函数在源码中采用完全相同的宏模板见 be/src/exprs/math_functions.cpp学习SIN的实现模式即可举一反三。使用注意事项弧度制SIN(30)的结果是30弧度的正弦约-0.988并非30°的正弦。如需角度制计算可先通过角度转弧度公式换算SIN(angle_in_degree * pi()/180)。精度边界由于DOUBLE是 IEEE 754 双精度浮点数参数接近π的整数倍时结果会呈现极小但非零的舍入误差如示例中的SIN(3.14)这是浮点运算的正常表现。NULL 与异常值NULL输入返回NULLNaN/±Infinity输入经NanCheck防护后返回NaN不会导致查询报错或 BE 进程异常。与其他三角函数协同SIN常与COS、TAN配合完成信号处理、坐标换算、统计计算等场景需要反函数时使用ASIN。总结SIN是 StarRocks 中一个接口简洁、语义明确的数学函数以DOUBLE弧度值入参返回DOUBLE正弦值。其背后则是一条从 FE 函数注册表gensrc/script/functions.py到 BE 向量化实现be/src/exprs/math_functions.cpp的完整链路体现了 StarRocks“SQL 接口简单、执行引擎高效”的设计理念。无论是日常数值分析还是深度理解 StarRocks 向量化表达式框架SIN都是一个理想的切入点。【免费下载链接】starrocksThe worlds fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocks创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考