Experience Edgeスキーマ

Search演算子の挙動

searchクエリは以下の演算子をサポートしています。

!注Searchオペレーターの挙動は、DeliveryエンドポイントかPreviewエンドポイント(トークン化された検索インデックスを使用する)かによって異なります。

• EQ (Equals) - 値が完全に一致するユーザー定義フィールドのみをマッチングします。

  • Deliveryエンドポイントでは、この演算子は完全に一致するユーザー定義フィールドのみをマッチングします。フィールド全体が検索値と完全に一致しなければならず、部分的なマッチングは返されません。

    例えば、EQ演算子でipsumを検索しても*、lorem ipsum dolor sit ametを含むフィールドにはマッチしませんが、ipsumの値が正確にipsum*であるフィールドにはマッチします。

  • プレビューエンドポイントでは、Solr検索インデックスのすべてのテキストフィールドがデフォルトでトークン化されているため、テキストフィールドのCONTAINS演算子として機能します。つまり、完全に一致すると予想されても複数の結果を返すことがあります。

    例えば、EQ演算子でipsumを検索すると、lorem ipsum dolor sit ametを含むフィールドの結果が返ってくることがあります。

    プレビューエンドポイントのEQと正確に一致させるために、SearchQueryFieldMapping機能を使ってトークン化されたフィールドを非トークン化された計算フィールドにマッピングしてください。関連するサポート記事も参照KB1003665。

  正確な全フィールドマッチングが必要な場合はこの演算子を使いましょうが、プレビューエンドポイントでのトークン化動作には注意してください。

• CONTAINS - フィールド内で部分文字列のマッチを行う。

  • Deliveryエンドポイントでは、トークン化やランキングなしでそのまま値がマッチングされます。

    例えば、CONTAINS演算子でipsumを検索すると、テキスト内のどこかに値が現れる任意のフィールド(例えばlorem ipsum dolor sit amet)と一致します。

  • プレビューエンドポイントでは、CONTAINSオペレーターがトークン化されたフィールド値に基づいて複数の結果を返すことができます。これはプレビューエンドポイントがトークン化された検索インデックスを使用しているためです。

  このオペレーターは部分的なテキストマッチや、フィールド内の単語やフレーズに基づくコンテンツのフィルタリングに使います。

!注GraphQLの検索フィールドは、全文検索やサイト検索機能の実装ではなく、コンテンツのフィルタリング用に設計されています。より高度な検索機能を求めるなら、専用の検索サービスの利用を検討してください。

Searchクエリの例

これはユーザー定義フィールド内のCONTAINS演算子を使ってアイテムを検索する例です:

query Search { search( where: { name: "title", value: "Sitecore", operator: CONTAINS } ) { results { id name } } }

こちらはユーザー定義のフィールドで正確な一致を使ったアイテム検索の例です:

query Search { search( where: { name: "_parent" value: "110D559FDEA542EA9C1C8A5DF7E70EF9" operator: EQ } ) { results { id name } } }

以下は複数の節を組み合わせる例です:

query Search { search( where: { AND: { name: "_parent" value: "110D559FDEA542EA9C1C8A5DF7E70EF9" operator: EQ }, { name: "title" value: "another" operator: CONTAINS }

} ) { results { id name } } }