PATINDEX (Transact-SQL)

适用于: SQL Server(所有受支持的版本) Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)

返回模式在指定表达式中第一次出现的起始位置;如果在所有有效的文本和字符数据类型中都找不到该模式,则返回零。

主题链接图标Transact-SQL 语法约定

语法

PATINDEX ( '%pattern%' , expression )  

注意

若要查看 SQL Server 2014 及更早版本的 Transact-SQL 语法,请参阅早期版本文档

参数

pattern
包含要查找的序列的字符表达式。 可以使用通配符;但 pattern 之前和之后必须有 % 字符(搜索第一个或最后一个字符时除外)。 pattern 是字符串数据类型类别的表达式。 pattern最多包含 8000 个字符

注意

虽然传统正则表达式在 SQL Server 中不受本机支持,但可以使用各种通配符表达式来实现类似的复杂模式匹配。 有关通配符语法的更多详细信息,请参阅字符串运算符文档。

expression
是一个expression,通常是针对指定模式搜索的列。 expression 是字符串数据类型类别的表达式

返回类型

bigint(如果 expression 的数据类型为 varchar(max) 或 nvarchar(max));否则为 int

注解

如果 pattern 或 expression 为 NULL,则 PATINDEX 返回 NULL

PATINDEX 的起始位置为 1。

PATINDEX 基于输入的排序规则执行比较。 若要以指定排序规则进行比较,则可以使用 COLLATE 将显式排序规则应用于输入。

补充字符(代理项对)

在使用 SC 排序规则时,返回值将 expression 参数中的任何 UTF-16 代理项对计为一个字符。 有关详细信息,请参阅 排序规则和 Unicode 支持

0x0000 (char(0)) 是 Windows 排序规则中未定义的字符,不能包括在 PATINDEX 中

示例

A. 简单 PATINDEX 示例

以下示例检查字符 ter 起始位置的短字符串 (interesting data)。

SELECT position = PATINDEX('%ter%', 'interesting data');  

下面是结果集:

position
--------
3

B. 在 PATINDEX 中使用模式

以下示例查找模式 ensure 在 AdventureWorks2019 数据库的 Document 表中 DocumentSummary 列特定行中的开始位置。

SELECT position = PATINDEX('%ensure%',DocumentSummary)  
FROM Production.Document  
WHERE DocumentNode = 0x7B40;  
GO   

下面是结果集。

position
--------  
64  

如果未使用 WHERE 子句限制要搜索的行,查询将返回表中的所有行,对找到该模式的行报告非零值,对未找到该模式的行报告零值。

C. 在 PATINDEX 中使用通配符

以下示例使用 % 和 _ 通配符查找模式 'en'(后跟任意一个字符和 'ure')在指定字符串中的开始位置(索引从 1 开始):

SELECT position = PATINDEX('%en_ure%', 'Please ensure the door is locked!');  

下面是结果集。

position
--------  
8  

PATINDEX 的作用与 LIKE 类似,因此,您可以使用任何通配符。 不必将模式放在百分号之间。 PATINDEX('a%', 'abc') 将返回 1;PATINDEX('%a', 'cba') 将返回 3。

LIKE 不同的是,PATINDEX 返回一个位置,这与 CHARINDEX 类似。

D. 将复杂的通配符表达式和 PATINDEX 结合使用

下面的示例使用 [^]字符串运算符查找不是数字、字母或空格的字符的位置。

SELECT position = PATINDEX('%[^ 0-9A-Za-z]%', 'Please ensure the door is locked!'); 

下面是结果集。

position
--------
33

E. 在 PATINDEX 中使用 COLLATE

以下示例使用 COLLATE 函数显式指定要搜索的表达式的排序规则。

USE tempdb;  
GO  
SELECT PATINDEX ( '%ein%', 'Das ist ein Test'  COLLATE Latin1_General_BIN) ;  
GO  

下面是结果集。

position
--------
9

F. 使用变量指定模式

下面的示例使用变量将值传递到 pattern 参数。 该示例使用 AdventureWorks2019 数据库。

DECLARE @MyValue VARCHAR(10) = 'safety';   
SELECT position = PATINDEX('%' + @MyValue + '%', DocumentSummary)   
FROM Production.Document  
WHERE DocumentNode = 0x7B40;  

下面是结果集。

position
--------  
22

另请参阅

LIKE (Transact-SQL)
CHARINDEX (Transact-SQL)
LEN (Transact-SQL)
数据类型 (Transact-SQL)
字符串函数 (Transact-SQL)
(通配符 - 要匹配的字符)(Transact-SQL)
(通配符 - 无需匹配的字符)(Transact-SQL)
_(通配符 - 匹配一个字符)(Transact-SQL)
百分比字符(通配符 - 需匹配的字符)(Transact-SQL)