isearch Función

Se aplica a:check marcado yes Databricks Runtime 19.0 y versiones posteriores

Importante

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

Devuelve true si search_pattern se encuentra en cualquiera de los valores de columna de destino proporcionados, sin distinción entre mayúsculas y minúsculas.

isearches la variante que no distingue mayúsculas de minúsculas de lasearch función con un comportamiento idéntico. Consulte search la función para obtener información completa sobre los tipos de argumentos, STRUCT la expansión y los modos admitidos.

Para obtener información sobre cómo acelerar las isearch consultas con índices de búsqueda de texto completo, consulte Índices de búsqueda de texto completo en tablas administradas del catálogo de Unity.

Syntax

isearch ( column [, ...], search_pattern [, mode => mode] )

Arguments

  • column: una o varias expresiones de destino que se pueden buscar. Consulte search la función para obtener la lista de tipos admitidos.
  • search_pattern: expresión plegable (constante) STRING con el valor que se va a buscar.
  • mode: un argumento con nombre STRING opcional. Uno de 'substring' (valor predeterminado) o 'word'.

Returns

Un objeto BOOLEAN.

  • true Si search_pattern se encuentra en cualquiera de los valores de columna de destino, omite mayúsculas y minúsculas.
  • NULL si search_pattern no se encuentra en ningún valor de columna de destino y al menos uno de esos valores es NULL.
  • De lo contrario, false.

Condiciones de error comunes

Ejemplos

-- isearch matches regardless of case.
> SELECT isearch(column, 'needle', mode => 'substring') FROM VALUES ('Needle') AS table(column);
 true

> SELECT isearch(column, 'NEEDLE') FROM VALUES ('needle in a haystack') AS table(column);
 true

-- search returns false for the same input because of the case mismatch.
> SELECT search(column, 'NEEDLE') FROM VALUES ('needle in a haystack') AS table(column);
 false

-- Word mode is also case-insensitive.
> SELECT isearch(column, 'QUICK fox', mode => 'word') FROM VALUES ('Quick Brown Fox') AS table(column);
 true