TEXTCONTAINS

Gilt für:Berechnete SpalteBerechnete TabelleMeasurevisuelle Berechnung

Gibt zurück TRUE , wenn Text in einer Spalte einer Suchzeichenfolge gemäß dem angegebenen Volltext-Suchmodus entspricht. Andernfalls wird FALSEzurückgegeben.

Syntax

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

Parameters

Begriff	Definition
within_text_column	Eine Spalte, die die zu durchsuchenden Textwerte enthält. Die Spalte muss über den Datentyp "String" verfügen.
search_text	Eine Textzeichenfolge, die die Suchbedingung definiert.
match_mode	(Optional) Das zu verwendende Abgleichsverhalten. Unterstützte Werte sind TEXTMATCHING, FUZZYMATCHINGund PHRASEMATCHING. Der Standardwert lautet TEXTMATCHING.

Zurückgegebener Wert

TRUEwenn der Text within_text_column in Übereinstimmungen search_text nach match_mode; andernfalls . FALSE

Übereinstimmungsmodi

Modus	Behavior
TEXTMATCHING	Tokenisiert und gleicht Text ab, der einen der Suchbegriffe search_text enthält.
FUZZYMATCHING	Gleicht Token ab, die suchtoken in einer kleinen Bearbeitungsdistanz ähneln, die typotolerante Übereinstimmungen unterstützt.
PHRASEMATCHING	Gleicht analysierte Token ab, die nebeneinander und in der angegebenen Reihenfolge angezeigt werden. Interpunktion wirkt sich nicht auf die Tokensequenz aus.

Hinweise

• Die Groß- und Kleinschreibung wird bei der Suche nicht berücksichtigt.
• Die Funktion wendet sprachspezifische Wortstamm- und Stoppwortentfernungen basierend auf der Modellkultur an. Beispielsweise ermöglicht die Wortstammerkennung eine Suche nach runrunningübereinstimmungen , , runsund runner. Das Entfernen von Stoppwörtern ignoriert allgemeine Füllwörter wie the, , and, ofund in.
• Die Sortierung pro Spalte steuert nicht die Analysesprache. Die Modellkultur steuert sie. Wählen Sie in Power BI Desktop "Dateioptionen>" und "Einstellungen>" ">Aktuelle Datei>"-Regionseinstellungsmodellsprache> aus, um die Modellsprache festzulegen. Weitere Informationen finden Sie unter FORMAT.
• Die unterstützten Modellkulturen sind:
  • Englisch (en)
  • Französisch (fr)
  • Deutsch (de)
  • Spanisch (es)
  • Portugiesisch (pt)
  • Russisch (ru)
  • Arabisch (ar)
  • Türkisch (tr)
  • Dänisch (da)
  • Niederländisch (nl)
  • Finnisch (fi)
  • Griechisch (el)
  • Ungarisch (hu)
  • Italienisch (it)
  • Norwegisch (no, nbund nn)
  • Rumänisch (ro)
  • Schwedisch (sv)
  • Tamilisch (ta)
• Bei nicht unterstützten Kulturen TEXTCONTAINS wird ein generischer Tokenizer in Kleinbuchstaben ohne Wortstamm- oder Stoppwortentfernung verwendet.
• Akzentfaltung wird nicht unterstützt. Beispielsweise stimmt café nicht mit cafe überein.
• Für die Funktion ist ein beibehaltener Volltextindex within_text_columnerforderlich. Es wird für import-, Dual- und Direct Lake-Speichermodi unterstützt. Andere Speichermodi geben einen Fehler zurück.
• Die Funktion wird zeileweise ausgewertet. Bevor Sie sie in einer berechneten Spalte über einer sehr großen Tabelle verwenden, testen Sie die Leistung mit einer repräsentativen Arbeitsauslastung.
• TEXTCONTAINS gibt einen booleschen Wert zurück und ist nicht für die Relevanzbewertung vorgesehen. Verwenden Sie TEXTSIMILARITY zum Rangieren von Übereinstimmungen.

Beispiele

Übereinstimmung mit einem beliebigen Suchbegriff

Die folgende Abfrage gibt Produkte zurück, deren Beschreibungen ein Token enthalten, das mit einem oderbluetooth:wireless

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

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

Abgleichen aller Suchbegriffe

Kombinieren Sie separate Anrufe mit dem && Betreiber, um alle Begriffe zu erfordern:

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

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

Suchen einer Fuzzy-Übereinstimmung

Die folgende Abfrage verwendet typotolerante Übereinstimmungen, um Kommentare zu finden, die ein Token ähnlich enthalten headphone:

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

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

Suchen einer Ausdrucksausgleichung

Die folgende Abfrage findet Beschreibungen, in denen noise sie nebeneinander und cancel in dieser Reihenfolge angezeigt werden:

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

Beispieltext	Result
Noise cancel headphones pro	TRUE
Cancel noise adapter	FALSE

Verwandte Inhalte

• CONTAINSSTRING
• TEXTIMILARITY
• Informationsfunktionen