You're viewing version 2.13 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Alias field type
An alias field type creates another name for an existing field. You can use aliases in thesearch and field capabilities API operations, with some exceptions. To set up an alias, you need to specify the original field name in the path
parameter.
Example
PUT movies
{
"mappings" : {
"properties" : {
"year" : {
"type" : "date"
},
"release_date" : {
"type" : "alias",
"path" : "year"
}
}
}
}
Parameters
Parameter | Description |
---|---|
path | The full path to the original field, including all parent objects. For example, parent.child.field_name. Required. |
Alias field
Alias fields must obey the following rules:
- An alias field can only have one original field.
- In nested objects, the alias must have the same nesting level as the original field.
To change the field that the alias references, update the mappings. Note that aliases in any previously stored percolator queries will still reference the original field.
Original field
The original field for an alias must obey the following rules:
- The original field must be created before the alias is created.
- The original field cannot be an object or another alias.
Using aliases in search API operations
You can use aliases in the following read operations of the search API:
- Queries
- Sorts
- Aggregations
stored_fields
docvalue_fields
- Suggestions
- Highlights
- Scripts that access field values
Using aliases in field capabilities API operations
To use an alias in the field capabilities API, specify it in the fields parameter.
GET movies/_field_caps?fields=release_date
Exceptions
You cannot use aliases in the following situations:
- In write requests, such as update requests.
- In multi-fields or as a target of
copy_to
. - As a _source parameter for filtering results.
- In APIs that take field names, such as term vectors.
- In
terms
,more_like_this
, andgeo_shape
queries (aliases are not supported when retrieving documents).
Wildcards
In search and field capabilities wildcard queries, both the original field and the alias are matched against the wildcard pattern.
GET movies/_field_caps?fields=release*