WARNING: Version 6.1 of Elasticsearch 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.

« _type field Mapping parameters »
Elastic Docs ›Elasticsearch Reference [6.1] ›Mapping ›Meta-Fields

_uid field

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

_uid field

edit

Deprecated in 6.0.0.

Now that types have been removed, documents are uniquely identified by their _id and the _uid field has only been kept as a view over the _id field for backward compatibility.

Each document indexed is associated with a _type (see Mapping Type) and an _id. These values are combined as {type}#{id} and indexed as the _uid field.

The value of the _uid field is accessible in queries, aggregations, scripts, and when sorting:

# Example documents
PUT my_index/my_type/1
{
  "text": "Document with ID 1"
}

PUT my_index/my_type/2?refresh=true
{
  "text": "Document with ID 2"
}
GET my_index/_search
{
  "query": {
    "terms": {
      "_uid": [ "my_type#1", "my_type#2" ] 
    }
  },
  "aggs": {
    "UIDs": {
      "terms": {
        "field": "_uid", 
        "size": 10
      }
    }
  },
  "sort": [
    {
      "_uid": { 
        "order": "desc"
      }
    }
  ],
  "script_fields": {
    "UID": {
      "script": {
         "lang": "painless",
         "source": "doc['_uid']" 
      }
    }
  }
}

Querying on the _uid field (also see the ids query)

Aggregating on the _uid field

Sorting on the _uid field

Accessing the _uid field in scripts
« _type field Mapping parameters »