TEXTCONTAINS

Dotyczy:kolumna obliczeniowatabela obliczeniowaMiarawizualizacji

Zwraca TRUE wartość , jeśli tekst w kolumnie pasuje do ciągu wyszukiwania zgodnie z określonym trybem wyszukiwania pełnotekstowego. W przeciwnym razie zwraca wartość FALSE.

Syntax

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

Parameters

Term	Definicja
within_text_column	Kolumna zawierająca wartości tekstowe do wyszukania. Kolumna musi mieć typ danych Ciąg.
search_text	Ciąg tekstowy definiujący warunek wyszukiwania.
match_mode	(Opcjonalnie) Zgodne zachowanie do użycia. Obsługiwane wartości to TEXTMATCHING, FUZZYMATCHINGi PHRASEMATCHING. Wartość domyślna to TEXTMATCHING.

Wartość zwracana

TRUE jeśli tekst w within_text_column dopasowaniach search_text jest match_modezgodny z ; w przeciwnym razie , FALSE.

Tryby dopasowania

Mode	Behavior
TEXTMATCHING	Tokenizuje i dopasuje search_text tekst, który zawiera dowolne terminy wyszukiwania.
FUZZYMATCHING	Dopasowuje tokeny podobne do tokenów wyszukiwania w niewielkiej odległości edycji, które obsługują dopasowywanie literówek.
PHRASEMATCHING	Dopasuj przeanalizowane tokeny, które pojawiają się obok siebie i w określonej kolejności. Interpunkcja nie ma wpływu na sekwencję tokenów.

Remarks

• Wyszukiwanie nie uwzględnia wielkości liter.
• Funkcja stosuje specyficzne dla języka usuwanie i zatrzymywanie wyrazów w oparciu o kulturę modelu. Na przykład funkcja stemming umożliwia wyszukiwanie run dopasowania do runningwartości , runsi runner. Usuwanie wyrazów zatrzymanych ignoruje typowe wyrazy wypełniacza, takie jak the, , andofi in.
• Sortowanie dla kolumn nie kontroluje języka analizatora. Kultura modelu kontroluje ją. W programie Power BI Desktop wybierz pozycję Opcje plików>i ustawienia>Opcje>Bieżące ustawienia regionalne>Język modeluustawień>, aby ustawić język modelu. Aby uzyskać więcej informacji, zobacz FORMAT.
• Obsługiwane kultury modeli to:
  • Angielski (en)
  • Francuski (fr)
  • Niemiecki (de)
  • Hiszpański (es)
  • Portugalski (pt)
  • Rosyjski (ru)
  • Arabski (ar)
  • Turecki (tr)
  • Duński (da)
  • Holenderski (nl)
  • Fiński (fi)
  • Grecki (el)
  • Węgierski (hu)
  • Włoski (it)
  • Norweski (no, nbi nn)
  • Rumuński (ro)
  • Szwedzki (sv)
  • Tamil (ta)
• W przypadku nieobsługiwanych kultur TEXTCONTAINS używa tokenizatora z małymi literami ogólnymi bez usuwania lub zatrzymywania wyrazów.
• Składanie akcentów nie jest obsługiwane. Na przykład café nie pasuje do cafe.
• Funkcja wymaga utrwalonego indeksu pełnotekstowego w pliku within_text_column. Jest obsługiwana w trybach magazynowania Import, Dual i Direct Lake. Inne tryby przechowywania zwracają błąd.
• Funkcja jest oceniana według wiersza. Przed użyciem jej w kolumnie obliczeniowej w bardzo dużej tabeli przetestuj wydajność przy użyciu reprezentatywnego obciążenia.
• TEXTCONTAINS Zwraca wartość logiczną i nie jest przeznaczona do klasyfikowania istotności. Użyj funkcji TEXTSIMILARITY , aby sklasyfikować dopasowania.

Przykłady

Dopasowanie dowolnego terminu wyszukiwania

Następujące zapytanie zwraca produkty, których opisy zawierają token zgodny z wireless wartością lub bluetooth:

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

Przykładowy tekst	Result
Wireless headphones with Bluetooth 5.0	TRUE
Wireless noise-cancelling headphones	TRUE
Wired headphones	FALSE

Dopasuj wszystkie terminy wyszukiwania

Połącz oddzielne wywołania z operatorem, && aby wymagać wszystkich terminów:

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

Przykładowy tekst	Result
Battery life is amazing	TRUE
Good life from this battery	TRUE
Battery charges fast	FALSE

Znajdowanie dopasowania rozmytego

Poniższe zapytanie używa dopasowania odpornego na literówkę, aby znaleźć komentarze zawierające token podobny do headphone:

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

Przykładowy tekst	Result
These headphones are great	TRUE
Best headfone I own	TRUE
Excellent earbuds	FALSE

Znajdowanie dopasowania frazy

Następujące zapytanie znajduje opisy, w których noise i cancel pojawiają się obok siebie i w tej kolejności:

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

Przykładowy tekst	Result
Noise cancel headphones pro	TRUE
Cancel noise adapter	FALSE

Treści powiązane

• CONTAINSSTRING
• SMSIMILARITY
• Funkcje informacyjne