- 类别:
字符串和二进制函数 (匹配/比较)
CONTAINS¶
如果 expr1
包含 expr2
,则返回 true。这两个表达式都必须是文本表达式或二进制表达式。
小技巧
您可以使用搜索优化服务,提高用于调用此函数的查询的性能。有关详细信息,请参阅 搜索优化服务。
语法¶
CONTAINS( <expr1> , <expr2> )
实参¶
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 |
---------+
以下示例将排序规则与 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 | +------------------------------------+