This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
« Mapper size plugin Mapper murmur3 plugin »
Elastic Docs ›Elasticsearch Plugins and Integrations [master] ›Mapper plugins ›Mapper size plugin

Using the _size field

edit

Using the _size field

edit

In order to enable the _size field, set the mapping as follows:

PUT my-index-000001
{
  "mappings": {
    "_size": {
      "enabled": true
    }
  }
}

The value of the _size field is accessible in queries, aggregations, scripts, and when sorting. It can be retrieved using the fields parameter:

# Example documents
PUT my-index-000001/_doc/1
{
  "text": "This is a document"
}

PUT my-index-000001/_doc/2
{
  "text": "This is another document"
}

GET my-index-000001/_search
{
  "query": {
    "range": {
      "_size": {                      
        "gt": 10
      }
    }
  },
  "aggs": {
    "sizes": {
      "terms": {
        "field": "_size",             
        "size": 10
      }
    }
  },
  "sort": [
    {
      "_size": {                      
        "order": "desc"
      }
    }
  ],
  "fields": ["_size"],                
  "script_fields": {
    "size": {
      "script": "doc['_size']"        
    }
  }
}

Querying on the _size field

Aggregating on the _size field

Sorting on the _size field

Use the fields parameter to return the _size in the search response.

Uses a script field to return the _size field in the search response.

Using _size in Kibana

To use the _size field in Kibana, update the metaFields setting and add _size to the list of meta fields. metaFields can be configured in Kibana from the Advanced Settings page in Management.

« Mapper size plugin Mapper murmur3 plugin »