TEXTCONTAINS

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Retourne TRUE si le texte d’une colonne correspond à une chaîne de recherche en fonction du mode de recherche en texte intégral spécifié. Sinon, la valeur FALSE est renvoyée.

Syntax

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

Parameters

Terme Définition
within_text_column Colonne qui contient les valeurs de texte à rechercher. La colonne doit avoir le type de données String.
search_text Chaîne de texte qui définit la condition de recherche.
match_mode (Facultatif) Comportement correspondant à utiliser. Les valeurs prises en charge sont TEXTMATCHING, FUZZYMATCHINGet PHRASEMATCHING. La valeur par défaut est TEXTMATCHING.

Valeur renvoyée

TRUE si le texte dans les within_text_column correspondances search_text est conforme ; match_modesinon, FALSE.

Modes de correspondance

Mode Comportement
TEXTMATCHING Tokenizes search_text et correspond au texte qui contient l’un des termes de recherche.
FUZZYMATCHING Correspond aux jetons similaires aux jetons de recherche dans une petite distance d’édition, qui prend en charge la correspondance à tolérance de faute de frappe.
PHRASEMATCHING Correspond aux jetons analysés qui apparaissent en regard des uns des autres et dans l’ordre spécifié. La ponctuation n’affecte pas la séquence de jetons.

Remarks

  • La recherche ne tient pas compte de la casse.
  • La fonction applique la suppression de mots vides et de recherche de mots spécifiques à la langue en fonction de la culture du modèle. Par exemple, la recherche run de recherche permet de faire correspondre running, runset runner. La suppression de mots vides ignore les mots de remplissage courants tels que the, and, of, et in.
  • Le classement par colonne ne contrôle pas la langue de l’analyseur. La culture du modèle le contrôle. Dans Power BI Bureau, sélectionnez Options de fichier>et paramètres>Options> dumodèle deparamètres> régionaux dufichier> actuel pour définir la langue du modèle. Pour plus d’informations, consultez FORMAT.
  • Les cultures de modèle prises en charge sont les suivantes :
    • Anglais (en)
    • Français (fr)
    • Allemand (de)
    • Espagnol (es)
    • Portugais (pt)
    • Russe (ru)
    • Arabe (ar)
    • Turc (tr)
    • Danois (da)
    • Néerlandais (nl)
    • Finnois (fi)
    • Grec (el)
    • Hongrois (hu)
    • Italien (it)
    • Norvégien (no, nbet nn)
    • Roumain (ro)
    • Suédois (sv)
    • Tamoul (ta)
  • Pour les cultures non prises en charge, TEXTCONTAINS utilise un tokenizer en minuscules générique sans suppression de mot de recherche ou de mot vide.
  • Le pliage d’accentuation n’est pas pris en charge. Par exemple, café ne correspond pas à cafe.
  • La fonction nécessite un index de recherche en texte intégral persistant sur within_text_column. Il est pris en charge pour les modes d’importation, de double et de stockage Direct Lake. D’autres modes de stockage retournent une erreur.
  • La fonction est évaluée par ligne. Avant de l’utiliser dans une colonne calculée sur une table très volumineuse, testez les performances avec une charge de travail représentative.
  • TEXTCONTAINS retourne une valeur booléenne et n’est pas destinée au classement de pertinence. Utilisez TEXTIMILARITY pour classer les correspondances.

Examples

Mettre en correspondance n’importe quel terme de recherche

La requête suivante retourne des produits dont les descriptions contiennent un jeton correspondant à l’un ou l’autre wireless des bluetoothéléments suivants :

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

Mettre en correspondance tous les termes de recherche

Combinez des appels distincts avec l’opérateur && pour exiger tous les termes :

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

Rechercher une correspondance approximative

La requête suivante utilise la correspondance avec tolérance de faute de frappe pour rechercher des commentaires qui contiennent un jeton similaire à headphone:

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

Rechercher une correspondance d’expression

La requête suivante recherche des descriptions dans lesquelles noise et cancel apparaissent en regard des autres et dans cet ordre :

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

Contenu connexe

  • Dernière mise à jour :