Categorias:: Funções de cadeia de caracteres e binários (Correspondência/Comparação)

CONTAINS¶

Retorna True se expr1 contiver expr2. Ambas as expressões devem ser de texto ou expressões binárias.

Dica

Você pode usar o serviço de otimização de pesquisa para melhorar o desempenho de consultas que chamam essa função. Para obter mais detalhes, consulte Serviço de otimização de pesquisa.

Sintaxe¶

CONTAINS( <expr1> , <expr2> )

Copy

Argumentos¶

expr1: A cadeia de caracteres a ser pesquisada.
expr2: A cadeia de caracteres a ser procurada.

Retornos¶

Retorna um BOOLEAN. O valor é True se expr2 for encontrado dentro de expr1. Retorna NULL se qualquer uma das expressões de entrada for NULL. Caso contrário, retorna False.

Detalhes do agrupamento¶

The collation specifications of all input arguments must be compatible.

Esta função não oferece suporte às seguintes especificações de agrupamento:

pi (não identifica pontuação).
cs-ai (diferencia maiúsculas e minúsculas, não identifica acentos).

Nota

Para usar esta função com uma coluna que tenha os especificadores de agrupamento upper ou lower, você deve ativar o pacote de mudança de comportamento 2024_02 em sua conta.

Para ativar este pacote em sua conta, execute a seguinte instrução:

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');

Copy

Exemplos¶

SELECT * from strings;

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

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

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

Copy

O exemplo a seguir utiliza CONTAINS com agrupamento:

-- 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