TEXTCONTAINS

применяется:вычисляемый столбецвычисляемой таблицыизмерениевизуального вычисления

Возвращает значение TRUE , если текст в столбце соответствует строке поиска в соответствии с указанным режимом полнотекстового поиска. В противном случае возвращается значение FALSE.

Syntax

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

Parameters

Срок	Определение
within_text_column	Столбец, содержащий текстовые значения для поиска. Столбец должен иметь тип данных String.
search_text	Текстовая строка, определяющая условие поиска.
match_mode	(Необязательно) Поведение сопоставления, используемое. Поддерживаются значения TEXTMATCHING, FUZZYMATCHING и PHRASEMATCHING. Значение по умолчанию — TEXTMATCHING.

Возвращаемое значение

Значение < a0/>, если текст в совпадениях соответствует ; в противном случае .

Режимы сопоставления

Режим	Behavior
TEXTMATCHING	Маркеризирует и сопоставляет search_text текст, содержащий любой из терминов поиска.
FUZZYMATCHING	Соответствует маркерам, похожим на маркеры поиска в пределах небольшого расстояния редактирования, который поддерживает сопоставление с типо-толерантным.
PHRASEMATCHING	Соответствует проанализированным маркерам, которые отображаются рядом друг с другом и в указанном порядке. Знак препинания не влияет на последовательность маркеров.

Замечания

• При поиске не учитывается регистр.
• Эта функция применяет логику для конкретного языка, а также удаление стоп-слов на основе языка и региональных параметров модели. Например, стебли позволяют искать run совпадения running, runsи runner. Удаление стоп-слов игнорирует распространенные слова заливки, такие как the, and, ofи in.
• Параметры сортировки по столбцам не управляют языком анализатора. Язык и региональные параметры модели управляет им. В Power BI Desktop выберите "Параметры>файла>" и параметры"Параметры текущего файла>"для языка моделирегиональных параметров>>, чтобы задать язык модели. Дополнительные сведения см. в разделе FORMAT.
• Поддерживаемые региональные параметры модели:
  • Английский (en)
  • Французский (fr)
  • Немецкий (de)
  • Испанский (es)
  • Португальский (pt)
  • Русский (ru)
  • Арабский (ar)
  • Турецкий (tr)
  • Датский (da)
  • Голландский (nl)
  • Финский (fi)
  • Греческий (el)
  • Венгерский (hu)
  • Итальянский (it)
  • Норвежский (no, nbи nn)
  • Румынский (ro)
  • Шведский (sv)
  • Тамиль (ta)
• Для неподдерживаемых языков и региональных параметров использует универсальный маркеризатор нижнего регистра без TEXTCONTAINS удаления стоп-слов или стоп-слов.
• Свертывание акцентов не поддерживается. Например, café не эквивалентно cafe.
• Для функции требуется сохраняемый полнотекстовый индекс within_text_column. Она поддерживается для режимов импорта, двойного и прямого хранилища Lake. Другие режимы хранения возвращают ошибку.
• Функция вычисляется по строкам. Прежде чем использовать его в вычисляемом столбце в очень большой таблице, проверьте производительность с помощью репрезентативной рабочей нагрузки.
• TEXTCONTAINS возвращает логическое значение и не предназначено для ранжирования релевантности. Используйте TEXTSIMILARITY для ранжирования совпадений.

Примеры

Совпадение с любым поисковым термином

Следующий запрос возвращает продукты, описания которых содержат маркер, соответствующий либо wirelessbluetooth:

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

Пример теста	Результат
Wireless headphones with Bluetooth 5.0	TRUE
Wireless noise-cancelling headphones	TRUE
Wired headphones	FALSE

Сопоставление всех условий поиска

Объединение отдельных вызовов с оператором для выполнения всех условий && :

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

Пример теста	Результат
Battery life is amazing	TRUE
Good life from this battery	TRUE
Battery charges fast	FALSE

Поиск нечеткого совпадения

Следующий запрос использует типо-нелерантное сопоставление для поиска комментариев, содержащих токен, аналогичный headphone:

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

Пример теста	Результат
These headphones are great	TRUE
Best headfone I own	TRUE
Excellent earbuds	FALSE

Поиск совпадения фраз

Следующий запрос находит описания, в которых noisecancel и отображаются рядом друг с другом и в этом порядке:

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

Пример теста	Результат
Noise cancel headphones pro	TRUE
Cancel noise adapter	FALSE

Связанные материалы

• CONTAINSSTRING
• ТЕКСТИМИЛАРНОСТЬ
• функции информационных функций