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。

返回值

如果匹配中的文本，则为 />;否则为 。

匹配模式

模式	Behavior
TEXTMATCHING	search_text标记并匹配包含任何搜索词的文本。
FUZZYMATCHING	匹配类似于在较小的编辑距离内搜索令牌的标记，该标记支持拼写错误匹配。
PHRASEMATCHING	匹配彼此旁边和按指定顺序显示的已分析标记。 标点符号不会影响令牌序列。

Remarks

• 搜索不区分大小写。
• 该函数基于模型区域性应用特定于语言的词干和停止词删除。 例如，词干分析允许搜索 run 匹配 running， runs以及 runner。 非索引字删除会忽略常见的填充词，例如the，ofand和in。
• 每列排序规则不控制分析器语言。 模型区域性控制它。 在 Power BI Desktop 中，选择“文件>选项”和“>选项>当前文件>区域设置>模型语言”以设置模型语言。 有关详细信息，请参阅 FORMAT。
• 支持的模型区域性为：
  • 英语（en）
  • 法语（fr）
  • 德语（de）
  • 西班牙语（es）
  • 葡萄牙语 (pt)
  • 俄语（ru）
  • 阿拉伯语（ar）
  • 土耳其语 (tr)
  • 丹麦语 (da)
  • 荷兰语 (nl)
  • 芬兰语 (fi)
  • 希腊语 (el)
  • 匈牙利语 (hu)
  • 意大利语（it）
  • 挪威语（no和nbnn）
  • 罗马尼亚语 (ro)
  • 瑞典语（sv）
  • 泰米尔语 （ta）
• 对于不支持的区域性，请使用一般小写标记器， TEXTCONTAINS 而无需删除词干或停止字删除。
• 不支持重音折叠。 例如，café 与 cafe 不匹配。
• 该函数需要保留的全文索引 within_text_column。 支持导入、双存储和 Direct Lake 存储模式。 其他存储模式返回错误。
• 该函数按行计算。 在计算列中对非常大的表使用它之前，请使用具有代表性的工作负荷测试性能。
• TEXTCONTAINS 返回布尔值，不用于相关性排名。 使用 TEXTSIMILARITY 对匹配项进行排名。

示例

匹配任何搜索词

以下查询返回其说明包含一个匹配或bluetooth以下标记wireless的产品：

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

查找短语匹配项

以下查询查找其旁边以及cancel按该顺序显示的说明noise：

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

示例文本	结果
Noise cancel headphones pro	TRUE
Cancel noise adapter	FALSE

相关内容

• CONTAINSSTRING
• TEXTSIMILARITY
• 信息函数