TEXTCONTAINS

Van toepassing op:berekende kolomberekende tabelMetingVisuele berekening

Retourneert TRUE of tekst in een kolom overeenkomt met een zoekreeks volgens de opgegeven zoekmodus voor volledige tekst. Anders wordt FALSE geretourneerd.

Syntax

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

Parameters

Term Definition
within_text_column Een kolom met de tekstwaarden die moeten worden gezocht. De kolom moet het gegevenstype Tekenreeks hebben.
search_text Een tekenreeks die de zoekvoorwaarde definieert.
match_mode (Optioneel) Het overeenkomende gedrag dat moet worden gebruikt. Ondersteunde waarden zijn TEXTMATCHING, FUZZYMATCHINGen PHRASEMATCHING. De standaardwaarde is TEXTMATCHING.

Retourwaarde

TRUEindien de tekst in within_text_column overeenstemming search_text is met match_mode; anders . FALSE

Overeenkomstmodi

Mode Gedrag
TEXTMATCHING Tokenizes en komt overeen met tekst die een van de zoektermen search_text bevat.
FUZZYMATCHING Komt overeen met tokens die vergelijkbaar zijn met zoektokens binnen een kleine bewerkingsafstand, die ondersteuning biedt voor typotolerante overeenkomsten.
PHRASEMATCHING Komt overeen met geanalyseerde tokens die naast elkaar en in de opgegeven volgorde worden weergegeven. Interpunctie heeft geen invloed op de tokenreeks.

Remarks

  • De zoekopdracht is niet hoofdlettergevoelig.
  • De functie past taalspecifieke stemming en stopwoordverwijdering toe op basis van de modelcultuur. Met stemming kan bijvoorbeeld worden gezocht naar run overeenkomsten running, runsen runner. Het verwijderen van stopwoorden negeert veelgebruikte opvulwoorden zoals the, and, ofen in.
  • Sortering per kolom bepaalt de analysetaal niet. De modelcultuur bepaalt het. Selecteer in Power BI Bureaublad de optie Bestandsopties>en instellingenOpties>>Huidig bestand>Landinstellingen>Modeltaal om de modeltaal in te stellen. Zie FORMAT voor meer informatie.
  • De ondersteunde modelculturen zijn:
    • Engels (en)
    • Frans (fr)
    • Duits (de)
    • Spaans (es)
    • Portugees (pt)
    • Russisch (ru)
    • Arabisch (ar)
    • Turkse (tr)
    • Deens (da)
    • Nederlands (nl)
    • Fins (fi)
    • Grieks (el)
    • Hongaars (hu)
    • Italiaans (it)
    • Noors (no, nben nn)
    • Roemeens (ro)
    • Zweeds (sv)
    • Tamil (ta)
  • Voor niet-ondersteunde culturen TEXTCONTAINS gebruikt u een generieke tokenizer in kleine letters zonder stemming of stopwoordverwijdering.
  • Accentvouwen wordt niet ondersteund. Bijvoorbeeld, café komt niet overeen met cafe.
  • Voor de functie is een permanente volledige-tekstindex within_text_columnvereist. Het wordt ondersteund voor de opslagmodi Import, Dual en Direct Lake. Andere opslagmodi retourneren een fout.
  • De functie wordt per rij geëvalueerd. Voordat u deze in een berekende kolom in een zeer grote tabel gebruikt, test u de prestaties met een representatieve workload.
  • TEXTCONTAINS retourneert een Booleaanse waarde en is niet bedoeld voor relevantieclassificatie. Gebruik TEXTSIMILARITY om overeenkomsten te rangschikken.

Voorbeelden

Overeenkomen met elke zoekterm

De volgende query retourneert producten waarvan de beschrijvingen een token bevatten dat overeenkomt met wireless of bluetooth:

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

Overeenkomen met alle zoektermen

Combineer afzonderlijke aanroepen met de && operator om alle voorwaarden te vereisen:

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

Een fuzzy overeenkomst zoeken

De volgende query maakt gebruik van typotolerante overeenkomsten om opmerkingen te vinden die een token bevatten dat vergelijkbaar is met headphone:

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

Een woordgroepovereenkomst zoeken

Met de volgende query worden beschrijvingen gevonden waarin noise naast elkaar en cancel in die volgorde worden weergegeven:

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