更新时间：2026-07-08 GMT+08:00
substr/substring
返回字符串 str 从 start_position 开始、长度为 length 的子串。substr 与 substring 功能相同。
命令格式
substr(string <str>, bigint <start_position>[, bigint <length>])
或
substring(string <str>, bigint <start_position>[, bigint <length>])
参数说明
| 参数 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| str | 是 | STRING | 待截取子串的字符串。 |
| start_position | 是 | BIGINT | 起始位置，从 1 开始。取值为正时从左边开始，取值为负时从右边开始。 |
| length | 否 | BIGINT | 子串的长度值，必须大于 0。省略时返回到 str 结尾的子串。 |
返回值说明
返回 STRING 类型。
- 当 length 被省略时，返回到 str 结尾的子串。
- str、start_position 或 length 值为 NULL 时，返回 NULL。
示例代码
返回 k SQL。
SELECT substr('Spark SQL', 5); 返回 SQL。
SELECT substr('Spark SQL', -3); 返回 k。
SELECT substr('Spark SQL', 5, 1); 父主题： 字符串函数
