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

Apache Doris 中文参考:SUBSTRING

· 52CE 我爱测

SUBSTRING 函数用于从字符串中提取子字符串。可以指定起始位置和长度,支持正向和反向提取。字符串中第一个字符的位置为 1。

描述

SUBSTRING 函数用于从字符串中提取子字符串。可以指定起始位置和长度,支持正向和反向提取。字符串中第一个字符的位置为 1。

别名

SUBSTR

MID

语法

SUBSTRING(<str>, <pos> [, <len>])

SUBSTRING(<str> FROM <pos> [FOR <len>])

参数

参数 说明
<str> 源字符串。类型:VARCHAR
<pos> 起始位置,可以为负数,起始为 1。类型:INT
<len> 可选参数,要提取的长度。类型:INT

返回值

返回 VARCHAR 类型,表示提取的子字符串。

特殊情况:

  • 如果任意参数为 NULL,返回 NULL
  • 如果 pos 为 0,返回空字符串
  • 如果 pos 为负数,从字符串末尾开始向前计数
  • 如果 pos 超出字符串长度,返回空字符串
  • 如果不指定 len,则返回从 pos 到字符串末尾的所有字符

示例

  1. 基本用法(指定起始位置)
SELECT substring('abc1', 2);
+-----------------------------+
| substring('abc1', 2)        |
+-----------------------------+
| bc1                         |
+-----------------------------+
  1. 使用负数位置
SELECT substring('abc1', -2);
+-----------------------------+
| substring('abc1', -2)       |
+-----------------------------+
| c1                          |
+-----------------------------+
  1. 位置为 0 的情况
SELECT substring('abc1', 0);
+----------------------+
| substring('abc1', 0) |
+----------------------+
|                      |
+----------------------+
  1. 位置超出字符串长度
SELECT substring('abc1', 5);
+-----------------------------+
| substring('abc1', 5)        |
+-----------------------------+
|                             |
+-----------------------------+
  1. 指定长度参数
SELECT substring('abc1def', 2, 2);
+-----------------------------+
| substring('abc1def', 2, 2)  |
+-----------------------------+
| bc                          |
+-----------------------------+
  1. 使用 from 和 for
SELECT substring('foobarbar' FROM 4 FOR 3);
+-------------------------------------+
| substring('foobarbar' FROM 4 FOR 3) |
+-------------------------------------+
| bar                                 |
+-------------------------------------+
  1. 使用 from
SELECT substring('foobarbar' FROM 4);
+-------------------------------+
| substring('foobarbar' FROM 4) |
+-------------------------------+
| barbar                        |
+-------------------------------+
  1. UTF-8 特殊字符支持
SELECT substring('ṭṛì ḍḍumai test', 5, 7);
+----------------------------------------+
| substring('ṭṛì ḍḍumai test', 5, 7)    |
+----------------------------------------+
| ḍḍumai                                 |
+----------------------------------------+
  1. NULL 值处理
SELECT substring(NULL, 1, 3);
+------------------------+
| substring(NULL, 1, 3)  |
+------------------------+
| NULL                   |
+------------------------+
  1. 空字符串
SELECT substring('', 1, 3);
+---------------------+
| substring('', 1, 3) |
+---------------------+
|                     |
+---------------------+
  1. 使用别名MID, 且返回结果为 NULL
SELECT MID(NULL, 2);
+--------------+
| MID(NULL, 2) |
+--------------+
| NULL         |
+--------------+
  1. 使用别名 SUBSTR
SELECT SUBSTR('Hello World', 7, 5);
+-----------------------------+
| SUBSTR('Hello World', 7, 5) |
+-----------------------------+
| World                       |
+-----------------------------+

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

资料来源与适用范围

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

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

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