TEXTCONTAINS

Se aplica a:columna Calculadatabla calculadaMedidacálculo visual

Devuelve TRUE si el texto de una columna coincide con una cadena de búsqueda según el modo de búsqueda de texto completo especificado. En caso contrario, devuelve FALSE.

Syntax

TEXTCONTAINS(<within_text_column>, <search_text>[, <match_mode>])

Parameters

Término Definición
within_text_column Columna que contiene los valores de texto que se van a buscar. La columna debe tener el tipo de datos String.
search_text Cadena de texto que define la condición de búsqueda.
match_mode (Opcional) Comportamiento coincidente que se va a usar. Los valores admitidos son TEXTMATCHING, FUZZYMATCHINGy PHRASEMATCHING. El valor predeterminado es TEXTMATCHING.

Valor de retorno

TRUE es si el texto de within_text_column coincide search_text con match_mode; de lo contrario, FALSEes .

Modos de coincidencia

Modo Comportamiento
TEXTMATCHING Tokeniza search_text y coincide con el texto que contiene cualquiera de los términos de búsqueda.
FUZZYMATCHING Coincide con los tokens que son similares a los tokens de búsqueda dentro de una distancia de edición pequeña, que admite la coincidencia con tolerancia a errores tipográficos.
PHRASEMATCHING Coincide con los tokens analizados que aparecen entre sí y en el orden especificado. La puntuación no afecta a la secuencia de tokens.

Remarks

  • La búsqueda no distingue mayúsculas de minúsculas.
  • La función aplica la lematización específica del lenguaje y la eliminación de palabras irrelevantes en función de la referencia cultural del modelo. Por ejemplo, la lematización permite que una búsqueda run coincida runningcon , runsy runner. La eliminación de palabras irrelevantes omite palabras de relleno comunes como the, and, ofy in.
  • La intercalación por columna no controla el lenguaje del analizador. La referencia cultural del modelo la controla. En Power BI Escritorio, seleccione Opciones de archivo>y configuración>Opciones Configuración>del archivo> actualIdioma del modelode configuración> regional para establecer el lenguaje del modelo. Para obtener más información, consulte FORMAT.
  • Las referencias culturales del modelo admitidas son:
    • Inglés (en)
    • Francés (fr)
    • Alemán (de)
    • Español (es)
    • Portugués (pt)
    • Ruso (ru)
    • Árabe (ar)
    • Turco (tr)
    • Danés (da)
    • Neerlandés (nl)
    • Finés (fi)
    • Griego (el)
    • Húngaro (hu)
    • Italiano (it)
    • Noruego (no, nby nn)
    • Rumano (ro)
    • Sueco (sv)
    • Tamil (ta)
  • Para referencias culturales no admitidas, TEXTCONTAINS usa un tokenizador en minúsculas genérico sin lematización ni eliminación de palabras irrelevantes.
  • No se admite el plegado de énfasis. Por ejemplo, café no coincide con cafe.
  • La función requiere un índice de texto completo persistente en within_text_column. Se admite para los modos de almacenamiento de Importación, Dual y Direct Lake. Otros modos de almacenamiento devuelven un error.
  • La función se evalúa fila por fila. Antes de usarlo en una columna calculada sobre una tabla muy grande, pruebe el rendimiento con una carga de trabajo representativa.
  • TEXTCONTAINS devuelve un valor booleano y no está pensado para la clasificación de relevancia. Use TEXTSIMILARITY para clasificar las coincidencias.

Ejemplos

Coincidencia con cualquier término de búsqueda

La consulta siguiente devuelve productos cuyas descripciones contienen un token que coincide con wireless o bluetooth:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "wireless bluetooth" )
)
Texto de ejemplo Result
Wireless headphones with Bluetooth 5.0 TRUE
Wireless noise-cancelling headphones TRUE
Wired headphones FALSE

Coincidencia con todos los términos de búsqueda

Combine llamadas independientes con el && operador para requerir todos los términos:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "battery" )
        && TEXTCONTAINS ( Reviews[Comment], "life" )
)
Texto de ejemplo Result
Battery life is amazing TRUE
Good life from this battery TRUE
Battery charges fast FALSE

Buscar una coincidencia aproximada

En la consulta siguiente se usa la coincidencia con tolerancia a errores tipográficos para buscar comentarios que contengan un token similar a headphone:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "headphone", FUZZYMATCHING )
)
Texto de ejemplo Result
These headphones are great TRUE
Best headfone I own TRUE
Excellent earbuds FALSE

Buscar una coincidencia de frases

La consulta siguiente busca descripciones en las que noise y cancel aparecen junto a otras y en ese orden:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "noise cancel", PHRASEMATCHING )
)
Texto de ejemplo Result
Noise cancel headphones pro TRUE
Cancel noise adapter FALSE

Contenido relacionado

  • Se actualizó por última vez el