如果欄位中的文字符合指定的全文搜尋模式,則回傳 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 |