Operador ilike
Aplica-se a: SQL do Databricks Runtime do Databricks
Retorna verdadeiro se str
corresponde pattern
a escape
sem diferenciação de maiúsculas e minúsculas.
Sintaxe
str [ NOT ] ilike ( pattern [ ESCAPE escape ] )
str [ NOT ] ilike { ANY | SOME | ALL } ( [ pattern [, ...] ] )
Argumentos
str
: uma expressão de CADEIA DE CARACTERES.pattern
: uma expressão de CADEIA DE CARACTERES.escape
: uma literal de STRING de caractere único.ANY
,SOME
ouALL
:Se
ALL
é especificado,ilike
retornatrue
sestr
corresponde a todos os padrões. Caso contrário, retornatrue
se ele corresponde a, pelo menos, um padrão.
Retornos
Um BOOLIANO.
O padrão é uma cadeia de caracteres cuja correspondência é feita literalmente e sem diferenciação de maiúsculas e minúsculas, com exceção dos seguintes símbolos especiais:
_
corresponde a qualquer caractere na entrada (semelhante a.
em expressões regulares do POSIX)%
corresponde a nenhum ou mais caracteres na entrada (semelhantes a.*
em expressões regulares do POSIX).
O caractere de escape padrão é o '\'
.
Se um caractere de escape precede um símbolo especial ou outro caractere de escape, o caractere seguinte será correspondido literalmente e sem diferenciação de maiúsculas e minúsculas.
Não é válido para escape de qualquer outro caractere.
Ao usar literais, use raw-literal
(prefixo r
) para evitar o pré-processamento do caractere de escape.
str NOT ilike ...
é equivalente a NOT(str ilike ...)
.
Exemplos
> SELECT ilike('Spark', '_PARK');
true
> SELECT r'%SystemDrive%\users\John' ilike r'\%SystemDrive\%\\Users%';
true
> SELECT r'%SystemDrive%\users\John' ilike '\%SystemDrive\%\\\\Users%';
true
> SELECT '%SystemDrive%/Users/John' ilike '/%SystemDrive/%//users%' ESCAPE '/';
true
> SELECT like('Spock', '_pArk');
false
> SELECT 'Spark' like SOME ('_ParK', '_Ock')
true
> SELECT 'Spark' like ALL ('_ParK', '_Ock')
false