elasticsearch/docs/reference/query-languages/query-dsl/query-dsl-parent-id-query.md

navigation_title	mapped_pages
Parent ID	https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-parent-id-query.html

Parent ID query [query-dsl-parent-id-query]

Returns child documents joined to a specific parent document. You can use a join field mapping to create parent-child relationships between documents in the same index.

Example request [parent-id-query-ex-request]

Index setup [parent-id-index-setup]

To use the parent_id query, your index must include a join field mapping. To see how you can set up an index for the parent_id query, try the following example.

1. Create an index with a join field mapping.

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

2. Index a parent document with an ID of 1.

   PUT /my-index-000001/_doc/1?refresh
   {
     "text": "This is a parent document.",
     "my-join-field": "my-parent"
   }
   

3. Index a child document of the parent document.

   PUT /my-index-000001/_doc/2?routing=1&refresh
   {
     "text": "This is a child document.",
     "my-join-field": {
       "name": "my-child",
       "parent": "1"
     }
   }
   

Example query [parent-id-query-ex-query]

The following search returns child documents for a parent document with an ID of 1.

GET /my-index-000001/_search
{
  "query": {
      "parent_id": {
          "type": "my-child",
          "id": "1"
      }
  }
}

Top-level parameters for parent_id [parent-id-top-level-params]

type

(Required, string) Name of the child relationship mapped for the join field.

id

(Required, string) ID of the parent document. The query will return child documents of this parent document.

ignore_unmapped

(Optional, Boolean) Indicates whether to ignore an unmapped type and not return any documents instead of an error. Defaults to false.

If false, {{es}} returns an error if the type is unmapped.

You can use this parameter to query multiple indices that may not contain the type.