WARNING: Version 5.x has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

› ›

Inner Hits Usage

edit

Inner Hits Usage

edit

The parent/child and nested features allow the return of documents that have matches in a different scope. In the parent/child case, parent document are returned based on matches in child documents or child document are returned based on matches in parent documents. In the nested case, documents are returned based on matches in nested inner objects.

In both cases, the actual matches in the different scopes that caused a document to be returned is hidden. In many cases, it’s very useful to know which inner nested objects (in the case of nested) or children/parent documents (in the case of parent/child) caused certain information to be returned. The inner hits feature can be used for this. This feature returns per search hit in the search response additional nested hits that caused a search hit to match in a different scope.

Inner hits can be used by defining an inner_hits definition on a nested, has_child or has_parent query and filter.

See the Elasticsearch documentation on Inner hits for more detail.

Global Inner Hits

edit

Fluent DSL example

edit

s => s
.Index(Index)
.InnerHits(ih => ih
    .Type<Earl>("earls", g => g
        .Size(5)
        .InnerHits(iih => iih
            .Type<Baron>("barons")
        )
        .FielddataFields(p => p.Name)
    )
)

Object Initializer syntax example

edit

new SearchRequest<Duke>(Index, typeof(Duke))
{
    InnerHits = new NamedInnerHits
    {
        { "earls", new InnerHitsContainer
        {
            Type = new TypeInnerHit<Earl>
            {
                InnerHit = new GlobalInnerHit
                {
                    Size = 5,
                    FielddataFields = new Field[]{ "name" },
                    InnerHits = new NamedInnerHits
                    {
                        { "barons", new TypeInnerHit<Baron>() }
                    }
                }
            }
        } }
    }
}

Example json output.

{
  "inner_hits": {
    "earls": {
      "type": {
        "earl": {
          "fielddata_fields": [
            "name"
          ],
          "inner_hits": {
            "barons": {
              "type": {
                "baron": {}
              }
            }
          },
          "size": 5
        }
      }
    }
  }
}

Query Inner Hits

edit

s => s
.Index(Index)
.Query(q =>
    q.HasChild<Prince>(hc => hc
        .Query(hcq => hcq.MatchAll())
        .InnerHits(ih => ih.Name("princes"))
    ) || q.Nested(n => n
        .Path(p => p.Foes)
        .Query(nq => nq.MatchAll())
        .InnerHits()
    )
)

Object Initializer syntax example

edit

new SearchRequest<King>(Index, typeof(King))
{
    Query = new HasChildQuery
    {
        Type = typeof(Prince),
        Query = new MatchAllQuery(),
        InnerHits = new InnerHits { Name = "princes" }
    } || new NestedQuery
    {
        Path = Field<King>(p => p.Foes),
        Query = new MatchAllQuery(),
        InnerHits = new InnerHits()
    }
}

Example json output.

{
  "query": {
    "bool": {
      "should": [
        {
          "has_child": {
            "type": "prince",
            "query": {
              "match_all": {}
            },
            "inner_hits": {
              "name": "princes"
            }
          }
        },
        {
          "nested": {
            "query": {
              "match_all": {}
            },
            "path": "foes",
            "inner_hits": {}
          }
        }
      ]
    }
  }
}

« Index Boost Usage Min Score Usage »