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

Apache Doris 中文参考:STARTS_WITH

· 52CE 我爱测

STARTS_WITH 函数用于检查字符串是否以指定的前缀开头。这是一个布尔函数,执行精确的前缀匹配,大小写敏感。

描述

STARTS_WITH 函数用于检查字符串是否以指定的前缀开头。这是一个布尔函数,执行精确的前缀匹配,大小写敏感。

语法

STARTS_WITH(<str>, <prefix>)

参数

参数 说明
<str> 要检查的主字符串。类型:VARCHAR
<prefix> 要匹配的前缀字符串。类型:VARCHAR

返回值

返回 BOOLEAN 类型(在 Doris 中以 TINYINT 形式显示,1 表示 true,0 表示 false)。

匹配规则:

  • 精确前缀匹配,大小写敏感
  • 空前缀与任何字符串都匹配(返回 true)
  • 支持 UTF-8 多字节字符的正确匹配
  • 前缀长度不能超过主字符串长度(除非前缀为空)

特殊情况:

  • 如果任一参数为 NULL,返回 NULL
  • 如果前缀为空字符串,返回 true(任何字符串都以空字符串开头)
  • 如果主字符串为空但前缀不为空,返回 false
  • 如果两者都为空字符串,返回 true

示例

  1. 基本前缀匹配
SELECT STARTS_WITH('hello world', 'hello'), STARTS_WITH('hello world', 'world');
+-------------------------------------+-------------------------------------+
| STARTS_WITH('hello world', 'hello') | STARTS_WITH('hello world', 'world') |
+-------------------------------------+-------------------------------------+
|                                   1 |                                   0 |
+-------------------------------------+-------------------------------------+
  1. 大小写敏感性
SELECT STARTS_WITH('Hello World', 'hello'), STARTS_WITH('Hello World', 'Hello');
+-------------------------------------+-------------------------------------+
| STARTS_WITH('Hello World', 'hello') | STARTS_WITH('Hello World', 'Hello') |
+-------------------------------------+-------------------------------------+
|                                   0 |                                   1 |
+-------------------------------------+-------------------------------------+
  1. NULL 值处理
SELECT STARTS_WITH(NULL, 'test'), STARTS_WITH('test', NULL);
+----------------------------+----------------------------+
| STARTS_WITH(NULL, 'test')  | STARTS_WITH('test', NULL)  |
+----------------------------+----------------------------+
| NULL                       | NULL                       |
+----------------------------+----------------------------+
  1. 空字符串处理
SELECT STARTS_WITH('hello', ''), STARTS_WITH('', 'world');
+---------------------------+----------------------------+
| STARTS_WITH('hello', '')  | STARTS_WITH('', 'world')   |
+---------------------------+----------------------------+
|                         1 |                          0 |
+---------------------------+----------------------------+
  1. 完整字符串匹配
SELECT STARTS_WITH('test', 'test'), STARTS_WITH('test', 'testing');
+-----------------------------+--------------------------------+
| STARTS_WITH('test', 'test') | STARTS_WITH('test', 'testing') |
+-----------------------------+--------------------------------+
|                           1 |                              0 |
+-----------------------------+--------------------------------+
  1. 文件路径检查
SELECT STARTS_WITH('/home/user/file.txt', '/home'), STARTS_WITH('C:\\Windows\\file.txt', 'C:\\');
+--------------------------------------------+------------------------------------------------+
| STARTS_WITH('/home/user/file.txt', '/home') | STARTS_WITH('C:\\Windows\\file.txt', 'C:\\')   |
+--------------------------------------------+------------------------------------------------+
|                                          1 |                                              1 |
+--------------------------------------------+------------------------------------------------+
  1. UTF-8 多字节字符
SELECT STARTS_WITH('ṭṛì ḍḍumai hello', 'ṭṛì'), STARTS_WITH('ṭṛì ḍḍumai hello', 'ḍḍumai');
+------------------------------------------+---------------------------------------------+
| STARTS_WITH('ṭṛì ḍḍumai hello', 'ṭṛì')   | STARTS_WITH('ṭṛì ḍḍumai hello', 'ḍḍumai')  |
+------------------------------------------+---------------------------------------------+
|                                        1 |                                           0 |
+------------------------------------------+---------------------------------------------+
  1. URL 和协议检查
SELECT STARTS_WITH('https://example.com', 'https://'), STARTS_WITH('ftp://server.com', 'http://');
+----------------------------------------------+---------------------------------------------+
| STARTS_WITH('https://example.com', 'https://') | STARTS_WITH('ftp://server.com', 'http://') |
+----------------------------------------------+---------------------------------------------+
|                                            1 |                                           0 |
+----------------------------------------------+---------------------------------------------+
  1. 数字字符串前缀
SELECT STARTS_WITH('123456789', '123'), STARTS_WITH('987654321', '123');
+----------------------------------+----------------------------------+
| STARTS_WITH('123456789', '123')  | STARTS_WITH('987654321', '123')  |
+----------------------------------+----------------------------------+
|                                1 |                                0 |
+----------------------------------+----------------------------------+
  1. 特殊字符和符号
SELECT STARTS_WITH('@username', '@'), STARTS_WITH('#hashtag', '#');
+-------------------------------+--------------------------------+
| STARTS_WITH('@username', '@') | STARTS_WITH('#hashtag', '#')   |
+-------------------------------+--------------------------------+
|                             1 |                              1 |
+-------------------------------+--------------------------------+

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

资料来源与适用范围

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

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

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