TEXTCONTAINS

適用於:匯出數據行計算數據表量值視覺計算

如果欄位中的文字符合指定的全文搜尋模式,則回傳 TRUE 該欄位的文字與搜尋字串相符。 否則會傳回 FALSE。

Syntax

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

Parameters

字詞 Definition
within_text_column 一欄包含要搜尋的文字值。 欄位必須有 String 資料型態。
search_text 一個定義搜尋條件的文字串。
match_mode (可選)要用的配對行為。 支援值為 TEXTMATCHING、 FUZZYMATCHING、 PHRASEMATCHING和 。 預設值為 TEXTMATCHING。

返回值

TRUE若 中的within_text_column文本符合search_textmatch_mode;否則,。 FALSE

比賽模式

Mode 行為
TEXTMATCHING 能標記並 search_text 匹配包含任何搜尋詞的文字。
FUZZYMATCHING 在較小的編輯距離內匹配類似搜尋標記的標記,支援容錯字匹配。
PHRASEMATCHING 配對分析依指定順序相鄰出現的代幣。 標點符號不會影響標記序列。

備註

  • 搜尋不區分大小寫。
  • 該功能根據模型文化應用語言特定的詞幹與終止詞移除。 例如,詞幹提取允許搜尋 以 run 匹配 running、 runs和 runner。 停止字移除會忽略常見的填充詞,如 the、 and、 ofin、 。
  • 每欄的排序並不控制分析器語言。 模特兒文化掌控著它。 在 Power BI 桌面版中,選擇檔案>選項與設定>選項>目前檔案>區域設定>模型語言以設定模型語言。 如需詳細資訊,請參閱 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有持久的全文索引。 它支援匯入、雙重和直接湖儲存模式。 其他儲存模式則會回傳錯誤訊息。
  • 函數會逐列評估。 在計算欄位使用非常大的表格前,先用具代表性的工作負載測試效能。
  • TEXTCONTAINS 回傳一個布林值,並非用於相關性排名。 使用 TEXTSIMILARITY 來進行排名匹配。

範例

匹配任何搜尋詞

以下查詢回傳描述中包含與或相符wirelessbluetooth的標記的產品:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "wireless bluetooth" )
)
範例測試 Result
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" )
)
範例測試 Result
Battery life is amazing TRUE
Good life from this battery TRUE
Battery charges fast FALSE

找一個模糊比對的

以下查詢使用容錯匹配來尋找包含類似 headphone標記的註解:

EVALUATE
FILTER (
    Reviews,
    TEXTCONTAINS ( Reviews[Comment], "headphone", FUZZYMATCHING )
)
範例測試 Result
These headphones are great TRUE
Best headfone I own TRUE
Excellent earbuds FALSE

尋找詞組匹配

以下查詢會尋找描述 noise 中 和 cancel 並列出現,且順序如下:

EVALUATE
FILTER (
    Products,
    TEXTCONTAINS ( Products[Description], "noise cancel", PHRASEMATCHING )
)
範例測試 Result
Noise cancel headphones pro TRUE
Cancel noise adapter FALSE