TEXTCONTAINS

gäller för:beräknad kolumnberäknad tabellMåttVisuell beräkning

Returnerar TRUE om text i en kolumn matchar en söksträng enligt det angivna fulltextsökläget. Annars returneras FALSE.

Syntax

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

Parameters

Term	Definition
within_text_column	En kolumn som innehåller textvärdena som ska sökas. Kolumnen måste ha datatypen Sträng.
search_text	En textsträng som definierar sökvillkoret.
match_mode	(Valfritt) Matchande beteende att använda. Värden som stöds är TEXTMATCHING, FUZZYMATCHINGoch PHRASEMATCHING. Standardvärdet är TEXTMATCHING.

Returvärde

TRUE om texten i within_text_column matchar search_text enligt match_mode, annars , FALSE.

Matchningslägen

Mode	Behavior
TEXTMATCHING	Tokeniserar search_text och matchar text som innehåller något av söktermerna.
FUZZYMATCHING	Matchar token som liknar söktoken inom ett litet redigeringsavstånd, som stöder typotolerant matchning.
PHRASEMATCHING	Matchar analyserade token som visas bredvid varandra och i den angivna ordningen. Skiljetecken påverkar inte tokensekvensen.

Remarks

• Sökningen är skiftlägesokänslig.
• Funktionen tillämpar språkspecifik borttagning av ord och borttagning av stoppord baserat på modellkulturen. Till exempel tillåter härstamning att en sökning efter run matchar running, runsoch runner. Stoppordsborttagning ignorerar vanliga fyllnadsord som the, and, ofoch in.
• Sortering per kolumn styr inte analysspråket. Modellkulturen styr den. I Power BI Desktop väljer du Filalternativ>och inställningar>Alternativ>Aktuell fil>Nationella inställningar>Modellspråk för att ange modellspråket. Mer information finns i FORMAT.
• De modellkulturer som stöds är:
  • Engelska (en)
  • Franska (fr)
  • Tyska (de)
  • Spanska (es)
  • Portugisiska (pt)
  • Ryska (ru)
  • Arabiska (ar)
  • Turkiska (tr)
  • Danska (da)
  • Nederländska (nl)
  • Finska (fi)
  • Grekiska (el)
  • Ungerska (hu)
  • Italienska (it)
  • Norska (no, nboch nn)
  • Rumänska (ro)
  • Svenska (sv)
  • Tamil (ta)
• För kulturer som inte stöds använder en allmän tokeniserare för gemener TEXTCONTAINS utan att härstamning eller borttagning av stoppord.
• Dekordelegering stöds inte. Till exempel matchar café inte cafe.
• Funktionen kräver ett beständiga fulltextindex på within_text_column. Det stöds för lagringslägena Import, Dual och Direct Lake. Andra lagringslägen returnerar ett fel.
• Funktionen utvärderas rad för rad. Testa prestandan med en representativ arbetsbelastning innan du använder den i en beräknad kolumn över en mycket stor tabell.
• TEXTCONTAINS returnerar ett booleskt värde och är inte avsett för relevansrankning. Använd TEXTSIMILARITY för att rangordna matchningar.

Examples

Matcha alla sökord

Följande fråga returnerar produkter vars beskrivningar innehåller en token som matchar antingen wireless eller bluetooth:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "wireless bluetooth" )
)

Exempeltext	Result
Wireless headphones with Bluetooth 5.0	TRUE
Wireless noise-cancelling headphones	TRUE
Wired headphones	FALSE

Matcha alla söktermer

Kombinera separata anrop med operatorn && för att kräva alla villkor:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "battery" )
        && TEXTCONTAINS ( Reviews[Comment], "life" )
)

Exempeltext	Result
Battery life is amazing	TRUE
Good life from this battery	TRUE
Battery charges fast	FALSE

Hitta en fuzzy-matchning

Följande fråga använder typotolerant matchning för att hitta kommentarer som innehåller en token som liknar headphone:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "headphone", FUZZYMATCHING )
)

Exempeltext	Result
These headphones are great	TRUE
Best headfone I own	TRUE
Excellent earbuds	FALSE

Hitta en frasmatchning

Följande fråga hittar beskrivningar där noise och cancel visas bredvid varandra och i den ordningen:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "noise cancel", PHRASEMATCHING )
)

Exempeltext	Result
Noise cancel headphones pro	TRUE
Cancel noise adapter	FALSE

Relaterat innehåll

• CONTAINSSTRING
• TEXTSIMILARITY
• Information-funktioner