ファジー（Fuzzy）

ファジークエリ

検索語に類似した用語を含む文書を返します。これは、レーヴェンシュタイン編集距離によって測定されます。

編集距離とは、ある用語を別の用語に変えるために必要な1文字の変更の数です。これらの変更には以下が含まれます：

• 文字の変更 (box → fox)
• 文字の削除 (black → lack)
• 文字の挿入 (sic → sick)
• 隣接する2文字の転置 (act → cat)

類似の用語を見つけるために、fuzzyクエリは指定された編集距離内での検索語のすべての可能なバリエーションまたは拡張のセットを作成します。クエリはその後、各拡張の正確な一致を返します。

例のリクエスト

シンプルな例

Python

resp = client.search(
   query={
   "fuzzy": {
   "user.id": {
   "value": "ki"
   }
   }
   },
)
print(resp)

Ruby

response = client.search(
  body: {
   query: {
   fuzzy: {
   'user.id' => {
   value: 'ki'
   }
   }
   }
  }
)
puts response

Js

const response = await client.search({
  query: {
   fuzzy: {
   "user.id": {
   value: "ki",
   },
   },
  },
});
console.log(response);

コンソール

GET /_search
{
  "query": {
   "fuzzy": {
   "user.id": {
   "value": "ki"
   }
   }
  }
}

高度なパラメータを使用した例

Python

resp = client.search(
   query={
   "fuzzy": {
   "user.id": {
   "value": "ki",
   "fuzziness": "AUTO",
   "max_expansions": 50,
   "prefix_length": 0,
   "transpositions": True,
   "rewrite": "constant_score_blended"
   }
   }
   },
)
print(resp)

Ruby

response = client.search(
  body: {
   query: {
   fuzzy: {
   'user.id' => {
   value: 'ki',
   fuzziness: 'AUTO',
   max_expansions: 50,
   prefix_length: 0,
   transpositions: true,
   rewrite: 'constant_score_blended'
   }
   }
   }
  }
)
puts response

Js

const response = await client.search({
  query: {
   fuzzy: {
   "user.id": {
   value: "ki",
   fuzziness: "AUTO",
   max_expansions: 50,
   prefix_length: 0,
   transpositions: true,
   rewrite: "constant_score_blended",
   },
   },
  },
});
console.log(response);

コンソール

GET /_search
{
  "query": {
   "fuzzy": {
   "user.id": {
   "value": "ki",
   "fuzziness": "AUTO",
   "max_expansions": 50,
   "prefix_length": 0,
   "transpositions": true,
   "rewrite": "constant_score_blended"
   }
   }
  }
}

ファジー用のトップレベルパラメータ

• <field>
• (必須、オブジェクト) 検索したいフィールド。

のパラメータ

• value
• (必須、文字列) 提供された<field>内で見つけたい用語。
• fuzziness
• (オプション、文字列) 一致のために許可される最大編集距離。 有効な値と詳細についてはFuzzinessを参照してください。
• max_expansions
• (オプション、整数) 作成される最大バリエーション数。 デフォルトは50です。
  max_expansionsパラメータで高い値を使用することは避けてください。特にprefix_lengthパラメータの値が0の場合は注意が必要です。max_expansionsパラメータの高い値は、調べるバリエーションの数が多いため、パフォーマンスの低下を引き起こす可能性があります。
• prefix_length
• (オプション、整数) 拡張を作成する際に変更されない最初の文字の数。 デフォルトは0です。
• transpositions
• (オプション、ブール値) 編集に隣接する2文字の転置を含めるかどうかを示します (ab → ba)。 デフォルトはtrueです。
• rewrite
• (オプション、文字列) クエリを再構築するために使用されるメソッド。 有効な値と詳細については、rewriteパラメータを参照してください。

ノート

search.allow_expensive_queriesがfalseに設定されている場合、ファジークエリは実行されません。