TEXTCONTAINS

適用対象: 計算列計算テーブルメジャービジュアル計算

指定したフルテキスト検索モードに従って、列内のテキストが検索文字列と一致する場合に TRUE を返します。 それ以外の場合は FALSEを返します。

Syntax

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

Parameters

任期 Definition
within_text_column 検索するテキスト値を含む列。 列には文字列データ型が必要です。
search_text 検索条件を定義するテキスト文字列。
match_mode (省略可能)使用する一致する動作。 サポートされている値は、 TEXTMATCHING、 FUZZYMATCHING、および PHRASEMATCHINGです。 既定値は TEXTMATCHING です。

値を返す

TRUE within_text_columnのテキストがmatch_modeに従ってsearch_textと一致する場合は ɭ。それ以外の場合はFALSE。

一致モード

モード Behavior
TEXTMATCHING search_textトークン化し、検索語句のいずれかを含むテキストと一致します。
FUZZYMATCHING 入力ミストレラントな一致をサポートする、小さな編集距離内の検索トークンに似たトークンを照合します。
PHRASEMATCHING 指定した順序で、互いに隣り合って表示される分析済みトークンと一致します。 句読点はトークン シーケンスに影響しません。

注釈

  • 検索では大文字と小文字が区別されません。
  • この関数は、モデル カルチャに基づいて言語固有のステミングとストップワードの削除を適用します。 たとえば、ステミングを使用すると、running、runs、およびrunnerと一致するrunを検索できます。 単語の削除を停止すると、 the、 and、 of、 inなどの一般的な入力者の単語が無視されます。
  • 列ごとの照合順序では、アナライザー言語は制御されません。 モデル カルチャによって制御されます。 Power BIデスクトップで、File>Options と settings>Options>Current file>Regional settings>Model 言語を選択してモデル言語を設定します。 詳細については、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に永続化されたフルテキスト インデックスが必要です。 インポート、デュアル、および Direct Lake ストレージ モードでサポートされています。 その他のストレージ モードではエラーが返されます。
  • 関数は行ごとに評価されます。 非常に大きなテーブルの計算列で使用する前に、代表的なワークロードでパフォーマンスをテストします。
  • TEXTCONTAINS はブール値を返し、関連性のランク付けを目的としていません。 TEXTSIMILARITY を使用して一致をランク付けします。

Examples

任意の検索語句と一致する

次のクエリは、説明に wireless または bluetoothに一致するトークンを含む製品を返します。

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

関連するコンテンツ

  • 最終更新: