[DOC] No documentation for nested query type

[navneet1v]

What do you want to do?

• Request a change to existing documentation
• Add new documentation
• Report a technical problem with the documentation
• Other

Tell us about your request. Provide a summary of the request and all versions that are affected.
No documentation present for nested query type in the Opensearch documentation. The feature is available since the inception of Opensearch.

What other resources are available? Provide links to related issues, POCs, steps for testing, etc.

PUT /navneet-index
{
  "mappings": {
    "properties": {
      "obj1": {
        "type": "nested"
      }
    }
  }
}

GET /navneet-index/_search
{
  "query": {
    "nested": {
      "path": "obj1",
      "query": {
        "bool": {
          "must": [
            { "match": { "obj1.name": "blue" } },
            { "range": { "obj1.count": { "gt": 5 } } }
          ]
        }
      },
      "score_mode": "avg"
    }
  }
}

[hdhalter]

Hi @navneet1v, We have documentation on the nested field type here: https://opensearch.org/docs/latest/field-types/supported-field-types/nested/#nested-field-type-1. Is this not what you are looking for? Thanks.

[navneet1v]

@hdhalter that is the nested field documentation. It is not the documentation on nested query. Both are different thing. I added an example in the gh issue where you see we have an option called as Score mode, this is an important parameter. It has various values like max, avg etc. Hence we should add a separate documentation for nested query and should not club this with nested fields.

[hdhalter]

Thanks for the clarification! I found this example of a nested query: https://opensearch.org/docs/latest/search-plugins/text-chunking/#step-4-search-the-index-using-neural-search, but we can add a new section for it.

[hdhalter]

This will be covered with the other query DSL types: #2173

[navneet1v]

Thanks for the clarification! I found this example of a nested query: https://opensearch.org/docs/latest/search-plugins/text-chunking/#step-4-search-the-index-using-neural-search, but we can add a new section for it.

The example is for neural query. Nested query can have any type of query inside it. I think we should have a separate documentation for nested query.

[leanneeliatra]

This will be covered with the other query DSL types: #2173

I think this is also linked to #7348 to highlight for @kolchfa-aws, if not, I can look into this ticket 7363. Thanks.