OpenSearch/docs/reference/query-dsl/queries/has-parent-query.asciidoc

84 lines
2.3 KiB
Plaintext

[[query-dsl-has-parent-query]]
=== Has Parent Query
The `has_parent` query works the same as the
<<query-dsl-has-parent-filter,has_parent>>
filter, by automatically wrapping the filter with a constant_score (when
using the default score type). It has the same syntax as the
<<query-dsl-has-parent-filter,has_parent>>
filter. This query is experimental and is available from version
`0.19.10`.
[source,js]
--------------------------------------------------
{
"has_parent" : {
"parent_type" : "blog",
"query" : {
"term" : {
"tag" : "something"
}
}
}
}
--------------------------------------------------
[float]
==== Scoring capabilities
The `has_parent` also has scoring support from version `0.20.2`. The
supported score types are `score` or `none`. The default is `none` and
this ignores the score from the parent document. The score is in this
case equal to the boost on the `has_parent` query (Defaults to 1). If
the score type is set to `score`, then the score of the matching parent
document is aggregated into the child documents belonging to the
matching parent document. The score type can be specified with the
`score_type` field inside the `has_parent` query:
[source,js]
--------------------------------------------------
{
"has_parent" : {
"parent_type" : "blog",
"score_type" : "score",
"query" : {
"term" : {
"tag" : "something"
}
}
}
}
--------------------------------------------------
[float]
==== Scope
The `_scope` support has been removed from version `0.90.beta1`. See:
https://github.com/elasticsearch/elasticsearch/issues/2606
A `_scope` can be defined on the filter allowing to run facets on the
same scope name that will work against the parent documents. For
example:
[source,js]
--------------------------------------------------
{
"has_parent" : {
"_scope" : "my_scope",
"parent_type" : "blog",
"query" : {
"term" : {
"tag" : "something"
}
}
}
}
--------------------------------------------------
[float]
==== Memory Considerations
With the current implementation, all `_id` values are loaded to memory
(heap) in order to support fast lookups, so make sure there is enough
memory for it.