[ NOT ] RLIKE¶

执行比较以确定字符串是否与指定模式相匹配。两个输入都必须是文本表达式。

RLIKE 与 [ NOT ] LIKE 函数类似，但使用 POSIX 扩展的正则表达式而不是 SQL LIKE 模式语法。它支持比 LIKE 更复杂的匹配条件。

小技巧

您可以使用搜索优化服务，提高用于调用此函数的查询的性能。有关详细信息，请参阅搜索优化服务。

REGEXP_COUNT、REGEXP_INSTR、REGEXP_REPLACE、REGEXP_SUBSTR、REGEXP_SUBSTR_ALL

[ NOT ] ILIKE、[ NOT ] LIKE

语法¶

-- 1st syntax
RLIKE( <subject> , <pattern> [ , <parameters> ] )

-- 2nd syntax
<subject> [ NOT ] RLIKE <pattern>

必填：

subject

用于搜索匹配项的字符串。

pattern

要匹配的模式。

有关指定模式的准则，请参阅字符串函数（正则表达式）。

可选：

parameters

包含一个或多个字符的字符串，指定用于搜索匹配项的参数。支持的值：


参数	描述
`c`	区分大小写的匹配
`i`	不区分大小写的匹配
`m`	多行模式
`e`	提取子匹配项
`s`	Single-line mode POSIX wildcard character `.` matches `\n`

默认：c

返回 BOOLEAN 或 NULL。

The function implicitly anchors a pattern at both ends (for example, '' automatically becomes '^$', and 'ABC' automatically becomes '^ABC$'). For example, to match any string starting with ABC, the pattern is 'ABC.*'.
反斜杠字符 (\) 是转义字符。有关更多信息，请参阅在以单引号括起的字符串常量中指定正则表达式。
有关更多使用说明，请参阅一般使用说明，了解正则表达式函数。

Arguments with collation specifications currently aren't supported.

运行以下命令，为本主题中的示例设置数据：

CREATE OR REPLACE TABLE rlike_ex(city VARCHAR(20));
INSERT INTO rlike_ex VALUES ('Sacramento'), ('San Francisco'), ('San Jose'), (null);

以下示例使用通配符执行不区分大小写的模式匹配：

SELECT * FROM rlike_ex WHERE RLIKE(city, 'san.*', 'i');

+---------------+
| CITY          |
|---------------|
| San Francisco |
| San Jose      |
+---------------+

SELECT * FROM rlike_ex WHERE NOT RLIKE(city, 'san.*', 'i');

+------------+
| CITY       |
|------------|
| Sacramento |
+------------+

以下示例确定字符串是否与电话号码和电子邮件地址的格式匹配。在这些示例中，正则表达式在放在美元符号内的字符串中指定，以避免将正则表达式中的反斜杠转义。

SELECT RLIKE('800-456-7891',
             $$[2-9]\d{2}-\d{3}-\d{4}$$) AS matches_phone_number;

+----------------------+
| MATCHES_PHONE_NUMBER |
|----------------------|
| True                 |
+----------------------+

SELECT RLIKE('jsmith@email.com',
             $$\w+@[a-zA-Z_]+\.[a-zA-Z]{2,3}$$) AS matches_email_address;

+-----------------------+
| MATCHES_EMAIL_ADDRESS |
|-----------------------|
| True                  |
+-----------------------+

以下示例执行相同的匹配，但使用放在单引号内的字符串常量来指定正则表达式。

由于示例使用放在单引号内的字符串常量，因此:ref:每个反斜杠都必须用另一个反斜杠进行转义<label-regexp_escape_character_caveats>。

SELECT RLIKE('800-456-7891',
             '[2-9]\\d{2}-\\d{3}-\\d{4}') AS matches_phone_number;

+----------------------+
| MATCHES_PHONE_NUMBER |
|----------------------|
| True                 |
+----------------------+

SELECT RLIKE('jsmith@email.com',
             '\\w+@[a-zA-Z_]+\\.[a-zA-Z]{2,3}') AS matches_email_address;

+-----------------------+
| MATCHES_EMAIL_ADDRESS |
|-----------------------|
| True                  |
+-----------------------+

或者重写语句，避免使用依赖反斜杠字符的序列。

SELECT RLIKE('800-456-7891',
             '[2-9][0-9]{2}-[0-9]{3}-[0-9]{4}') AS matches_phone_number;

+----------------------+
| MATCHES_PHONE_NUMBER |
|----------------------|
| True                 |
+----------------------+

SELECT RLIKE('jsmith@email.com',
             '[a-zA-Z_]+@[a-zA-Z_]+\\.[a-zA-Z]{2,3}') AS matches_email_address;

+-----------------------+
| MATCHES_EMAIL_ADDRESS |
|-----------------------|
| True                  |
+-----------------------+

以下示例使用通配符执行不区分大小写的模式匹配：

SELECT * FROM rlike_ex WHERE city RLIKE 'San.* [fF].*';

+---------------+
| CITY          |
|---------------|
| San Francisco |
+---------------+

有关正则表达式的其他示例，请参阅 [ NOT ] REGEXP。