类别:

字符串和二进制函数 (匹配/比较)

CONTAINS

如果 expr1 包含 expr2,则返回 true。这两个表达式都必须是文本表达式或二进制表达式。

小技巧

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

语法

CONTAINS( <expr1> , <expr2> )
Copy

实参

expr1

要在其中搜索的字符串。

expr2

要搜索的字符串。

返回

返回 BOOLEAN。如果在 expr1 中找到 expr2,则返回值为 True。如果任一输入表达式为 NULL,则返回 NULL。否则,返回 False。

排序规则详细信息

The collation specifications of all input arguments must be compatible.

此函数不支持以下排序规则规范:

  • pi (不区分标点符号)。

  • cs-ai (区分大小写,不区分重音)。

示例

SELECT * from strings;

---------+
    S    |
---------+
 coffee  |
 ice tea |
 latte   |
 tea     |
 [NULL]  |
---------+

SELECT * FROM strings WHERE CONTAINS(s, 'te');

---------+
    S    |
---------+
 ice tea |
 latte   |
 tea     |
---------+
Copy

以下示例将排序规则与 CONTAINS 结合使用:

-- Should return True.
SELECT CONTAINS(COLLATE('ñn', 'sp'), COLLATE('n', 'sp'));
+---------------------------------------------------+
| CONTAINS(COLLATE('ÑN', 'SP'), COLLATE('N', 'SP')) |
|---------------------------------------------------|
| True                                              |
+---------------------------------------------------+
SELECT CONTAINS(COLLATE('ñn', 'sp'), 'n');
+------------------------------------+
| CONTAINS(COLLATE('ÑN', 'SP'), 'N') |
|------------------------------------|
| True                               |
+------------------------------------+
Copy
语言: 中文