StarRocks reverse 函数详解字符串与数组反转的语法、限制与实现原理【免费下载链接】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 内置函数reverse()展开该函数用于将字符串字符或一维数组元素按相反顺序重新排列是 ETL 清洗、日志处理、序列反转等 SQL 场景中常用的内置函数。读完本文你将掌握reverse()的完整语法、参数类型约束、返回值规则与可运行的 SQL 示例并通过 BEBackend与 FEFrontend源码理解其在 StarRocks 内部的向量化执行机制。函数概览reverse是 StarRocks 内置的标量函数scalar function可作用于字符串与数组两类数据对字符串将字符串中的字符按逆序输出例如reverse(hello)返回olleh对数组将数组中的元素按逆序排列例如reverse([4,1,5,8])返回[8,5,1,4]。该函数由 FE 端在 FunctionSet.java 中以REVERSE reverse注册为内建函数并由 BE 端向量化执行引擎实现属于开箱即用的系统函数无需额外配置或创建。语法reverse(param)参数说明param待反转的字符串或数组支持以下数据类型类别支持的类型字符串VARCHAR、CHAR数组ARRAY当param为数组时当前版本只支持一维数组且数组元素不能为 DECIMAL 类型。支持的元素类型如下BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、VARCHAR、DECIMALV2、DATETIME、DATE、JSON说明JSON 类型元素自 StarRocks 2.5 版本起开始支持。返回值返回类型与param的类型保持一致即反转字符串仍返回字符串反转数组仍返回同类型数组不会发生类型转换。使用示例示例 1反转字符串MySQL SELECT REVERSE(hello); ------------------ | REVERSE(hello) | ------------------ | olleh | ------------------ 1 row in set (0.00 sec)示例 2反转一维数组MYSQL SELECT REVERSE([4,1,5,8]); -------------------- | REVERSE([4,1,5,8)] | -------------------- | [8,5,1,4] | --------------------示例 3在表查询中应用将reverse()与列引用结合使用可以完成字段级的字符或元素反转-- 反转字符串列 SELECT reverse(name) FROM user_profile; -- 反转数组列 SELECT reverse(tags) FROM article WHERE id 1001; -- 与字符串函数组合使用 SELECT reverse(lower(StarRocks));当传入的字符串或数组为NULL时函数返回NULL。源码级实现原理reverse()在 FE 与 BE 两个层面协同工作理解其实现有助于评估性能特征与适用范围。字符串反转区分 ASCII 与 UTF-8 两条路径字符串反转的入口位于 BE 端 string_functions.cppStatusOrColumnPtr StringFunctions::reverse(FunctionContext* context, const Columns columns) { return VectorizedUnaryFunctionReverseFunction::evaluateTYPE_VARCHAR(columns[0]); }其核心是ReverseFunction模板string_functions.cpp实现上会对输入字符串做一次快速 ASCII 判定validate_ascii_fast若整串为 ASCII走reversetrue路径使用ascii_reverse_per_slice按字节直接反转性能最优若包含非 ASCII 字符如中文等多字节 UTF-8 字符走reversefalse路径使用utf8_reverse_per_slice按 UTF-8 字符边界反转保证多字节字符不会被截断或乱码。因此reverse()对中文等多字节字符同样安全只是会切换至 UTF-8 感知路径处理开销略高。数组反转按列类型分派数组反转由ArrayReverse模板类实现位于 array_functions.tpp入口process()首先处理空列与常量列only_null/unpack_and_duplicate_const_column随后根据数组元素类型分派到不同的底层反转例程_reverse_fixed_column针对 BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DATETIME、DATE 等定长类型基于数组偏移量对元素块调用std::reverse_reverse_binary_column针对 VARCHAR 等变长类型先反转偏移量再反转字节区并逐字符串回正保证每个字符串内部字节序不变_reverse_json_column针对 JSON 元素直接对 JsonColumn 的字符串池做反转DECIMALV2等其余类型则走_reverse_data_column的通用定长/变长分支。从该实现可以看出数组反转是**逐行按数组**进行的原地/拷贝反转反转的是“元素顺序”而非元素本身因此对于元素为复杂对象如 JSON的数组同样成立。函数注册链路FE 端在 FunctionSet.java 声明REVERSE reverse并完成内建函数注册随后由 SQL 优化器将reverse()下推至 BE 的向量化执行算子。在执行期BE 依据参数类型分别派发到上述字符串或数组实现路径。使用限制与注意事项使用reverse()时请留意以下几点仅支持一维数组多维嵌套数组不在支持范围内DECIMAL 元素不支持若数组元素为 DECIMAL 类型函数将无法处理若需对数值反转可先将 DECIMAL 转成 VARCHAR 再调用JSON 元素版本要求JSON 类型的数组元素需要 StarRocks 2.5 及以上版本NULL 语义输入为NULL时返回NULL多字节安全对字符串执行反转时StarRocks 会按字符边界处理 UTF-8 编码无需担心中文等字符被截断。总结reverse()是一个轻量但实用的系统函数字符串场景下自动区分 ASCII 与 UTF-8 两条执行路径保证正确性与性能数组场景下按元素类型分派到定长、变长或 JSON 专用反转例程。无论是清洗反序存储的日志字符串还是翻转数组列中的元素顺序都可以直接使用SELECT reverse(...)完成无需编写自定义 UDF。更多数组相关函数可参考 array-functions 所在目录下的其他文档。【免费下载链接】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），仅供参考 StarRocks reverse 函数详解：字符串与数组反转的语法、限制与实现原理
StarRocks reverse 函数详解字符串与数组反转的语法、限制与实现原理【免费下载链接】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 内置函数reverse()展开该函数用于将字符串字符或一维数组元素按相反顺序重新排列是 ETL 清洗、日志处理、序列反转等 SQL 场景中常用的内置函数。读完本文你将掌握reverse()的完整语法、参数类型约束、返回值规则与可运行的 SQL 示例并通过 BEBackend与 FEFrontend源码理解其在 StarRocks 内部的向量化执行机制。函数概览reverse是 StarRocks 内置的标量函数scalar function可作用于字符串与数组两类数据对字符串将字符串中的字符按逆序输出例如reverse(hello)返回olleh对数组将数组中的元素按逆序排列例如reverse([4,1,5,8])返回[8,5,1,4]。该函数由 FE 端在 FunctionSet.java 中以REVERSE reverse注册为内建函数并由 BE 端向量化执行引擎实现属于开箱即用的系统函数无需额外配置或创建。语法reverse(param)参数说明param待反转的字符串或数组支持以下数据类型类别支持的类型字符串VARCHAR、CHAR数组ARRAY当param为数组时当前版本只支持一维数组且数组元素不能为 DECIMAL 类型。支持的元素类型如下BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、VARCHAR、DECIMALV2、DATETIME、DATE、JSON说明JSON 类型元素自 StarRocks 2.5 版本起开始支持。返回值返回类型与param的类型保持一致即反转字符串仍返回字符串反转数组仍返回同类型数组不会发生类型转换。使用示例示例 1反转字符串MySQL SELECT REVERSE(hello); ------------------ | REVERSE(hello) | ------------------ | olleh | ------------------ 1 row in set (0.00 sec)示例 2反转一维数组MYSQL SELECT REVERSE([4,1,5,8]); -------------------- | REVERSE([4,1,5,8)] | -------------------- | [8,5,1,4] | --------------------示例 3在表查询中应用将reverse()与列引用结合使用可以完成字段级的字符或元素反转-- 反转字符串列 SELECT reverse(name) FROM user_profile; -- 反转数组列 SELECT reverse(tags) FROM article WHERE id 1001; -- 与字符串函数组合使用 SELECT reverse(lower(StarRocks));当传入的字符串或数组为NULL时函数返回NULL。源码级实现原理reverse()在 FE 与 BE 两个层面协同工作理解其实现有助于评估性能特征与适用范围。字符串反转区分 ASCII 与 UTF-8 两条路径字符串反转的入口位于 BE 端 string_functions.cppStatusOrColumnPtr StringFunctions::reverse(FunctionContext* context, const Columns columns) { return VectorizedUnaryFunctionReverseFunction::evaluateTYPE_VARCHAR(columns[0]); }其核心是ReverseFunction模板string_functions.cpp实现上会对输入字符串做一次快速 ASCII 判定validate_ascii_fast若整串为 ASCII走reversetrue路径使用ascii_reverse_per_slice按字节直接反转性能最优若包含非 ASCII 字符如中文等多字节 UTF-8 字符走reversefalse路径使用utf8_reverse_per_slice按 UTF-8 字符边界反转保证多字节字符不会被截断或乱码。因此reverse()对中文等多字节字符同样安全只是会切换至 UTF-8 感知路径处理开销略高。数组反转按列类型分派数组反转由ArrayReverse模板类实现位于 array_functions.tpp入口process()首先处理空列与常量列only_null/unpack_and_duplicate_const_column随后根据数组元素类型分派到不同的底层反转例程_reverse_fixed_column针对 BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DATETIME、DATE 等定长类型基于数组偏移量对元素块调用std::reverse_reverse_binary_column针对 VARCHAR 等变长类型先反转偏移量再反转字节区并逐字符串回正保证每个字符串内部字节序不变_reverse_json_column针对 JSON 元素直接对 JsonColumn 的字符串池做反转DECIMALV2等其余类型则走_reverse_data_column的通用定长/变长分支。从该实现可以看出数组反转是**逐行按数组**进行的原地/拷贝反转反转的是“元素顺序”而非元素本身因此对于元素为复杂对象如 JSON的数组同样成立。函数注册链路FE 端在 FunctionSet.java 声明REVERSE reverse并完成内建函数注册随后由 SQL 优化器将reverse()下推至 BE 的向量化执行算子。在执行期BE 依据参数类型分别派发到上述字符串或数组实现路径。使用限制与注意事项使用reverse()时请留意以下几点仅支持一维数组多维嵌套数组不在支持范围内DECIMAL 元素不支持若数组元素为 DECIMAL 类型函数将无法处理若需对数值反转可先将 DECIMAL 转成 VARCHAR 再调用JSON 元素版本要求JSON 类型的数组元素需要 StarRocks 2.5 及以上版本NULL 语义输入为NULL时返回NULL多字节安全对字符串执行反转时StarRocks 会按字符边界处理 UTF-8 编码无需担心中文等字符被截断。总结reverse()是一个轻量但实用的系统函数字符串场景下自动区分 ASCII 与 UTF-8 两条执行路径保证正确性与性能数组场景下按元素类型分派到定长、变长或 JSON 专用反转例程。无论是清洗反序存储的日志字符串还是翻转数组列中的元素顺序都可以直接使用SELECT reverse(...)完成无需编写自定义 UDF。更多数组相关函数可参考 array-functions 所在目录下的其他文档。【免费下载链接】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），仅供参考