子を持つ（Has child）

子クエリを持つ

指定されたクエリに一致する子ドキュメントを持つ親ドキュメントを返します。同じインデックス内のドキュメント間で親子関係を作成するには、joinフィールドマッピングを使用します。

結合を行うため、has_childは他のクエリに比べて遅くなります。一意の親ドキュメントを指す一致する子ドキュメントの数が増えるにつれて、そのパフォーマンスは低下します。検索内の各has_childクエリは、クエリ時間を大幅に増加させる可能性があります。

クエリパフォーマンスが重要な場合は、このクエリを使用しないでください。has_childクエリを使用する必要がある場合は、できるだけ少なく使用してください。

リクエストの例

インデックス設定

#### Python
``````python
resp = client.indices.create(
   index="my-index-000001",
   mappings={
   "properties": {
   "my-join-field": {
   "type": "join",
   "relations": {
   "parent": "child"
   }
   }
   }
   },
)
print(resp)
`

Ruby

response = client.indices.create(
  index: 'my-index-000001',
  body: {
   mappings: {
   properties: {
   "my-join-field": {
   type: 'join',
   relations: {
   parent: 'child'
   }
   }
   }
   }
  }
)
puts response

Js

const response = await client.indices.create({
  index: "my-index-000001",
  mappings: {
   properties: {
   "my-join-field": {
   type: "join",
   relations: {
   parent: "child",
   },
   },
   },
  },
});
console.log(response);

コンソール

PUT /my-index-000001
{
  "mappings": {
   "properties": {
   "my-join-field": {
   "type": "join",
   "relations": {
   "parent": "child"
   }
   }
   }
  }
}

クエリの例

Python

resp = client.search(
   query={
   "has_child": {
   "type": "child",
   "query": {
   "match_all": {}
   },
   "max_children": 10,
   "min_children": 2,
   "score_mode": "min"
   }
   },
)
print(resp)

Js

const response = await client.search({
  query: {
   has_child: {
   type: "child",
   query: {
   match_all: {},
   },
   max_children: 10,
   min_children: 2,
   score_mode: "min",
   },
  },
});
console.log(response);

コンソール

GET /_search
{
  "query": {
   "has_child": {
   "type": "child",
   "query": {
   "match_all": {}
   },
   "max_children": 10,
   "min_children": 2,
   "score_mode": "min"
   }
  }
}

has_childのトップレベルパラメータ

• type
• （必須、文字列）joinフィールドにマッピングされた子関係の名前。
• query
• （必須、クエリオブジェクト）typeフィールドの子ドキュメントに対して実行したいクエリ。子ドキュメントが検索に一致する場合、クエリは親ドキュメントを返します。
• ignore_unmapped
• （オプション、ブール値）マッピングされていないtypeを無視し、エラーの代わりにドキュメントを返さないかどうかを示します。デフォルトはfalseです。
  falseの場合、Elasticsearchはtypeがマッピングされていない場合にエラーを返します。
  このパラメータを使用して、typeを含まない可能性のある複数のインデックスをクエリできます。
• max_children
• （オプション、整数）返された親ドキュメントに対して許可されるqueryに一致する子ドキュメントの最大数。この制限を超える親ドキュメントは、検索結果から除外されます。
• min_children
• （オプション、整数）返された親ドキュメントのクエリに一致するために必要なqueryに一致する子ドキュメントの最小数。この制限を満たさない親ドキュメントは、検索結果から除外されます。
• score_mode
• （オプション、文字列）一致する子ドキュメントのスコアがルート親ドキュメントの関連スコアにどのように影響するかを示します。有効な値は：
  • none（デフォルト）
  • 一致する子ドキュメントの関連スコアを使用しません。クエリは親ドキュメントに0のスコアを割り当てます。
  • avg
  • 一致するすべての子ドキュメントの平均関連スコアを使用します。
  • max
  • 一致するすべての子ドキュメントの最高関連スコアを使用します。
  • min
  • 一致するすべての子ドキュメントの最低関連スコアを使用します。
  • sum
  • 一致するすべての子ドキュメントの関連スコアを合計します。

ノート

ソート

子ドキュメントのフィールドで返されたドキュメントをソートする必要がある場合は、`````function_score`````クエリを使用し、`````_score`````でソートします。例えば、次のクエリは、子ドキュメントの`````click_count`````フィールドで返されたドキュメントをソートします。
#### Python
``````python
resp = client.search(
   query={
   "has_child": {
   "type": "child",
   "query": {
   "function_score": {
   "script_score": {
   "script": "_score * doc['click_count'].value"
   }
   }
   },
   "score_mode": "max"
   }
   },
)
print(resp)
`

Js

const response = await client.search({
  query: {
   has_child: {
   type: "child",
   query: {
   function_score: {
   script_score: {
   script: "_score * doc['click_count'].value",
   },
   },
   },
   score_mode: "max",
   },
  },
});
console.log(response);

コンソール

GET /_search
{
  "query": {
   "has_child": {
   "type": "child",
   "query": {
   "function_score": {
   "script_score": {
   "script": "_score * doc['click_count'].value"
   }
   }
   },
   "score_mode": "max"
   }
  }
}