parent
815f3d526e
commit
029869eb35
|
@ -1,7 +1,7 @@
|
||||||
[[mapper-size]]
|
[[mapper-size]]
|
||||||
=== Mapper Size Plugin
|
=== Mapper Size Plugin
|
||||||
|
|
||||||
The mapper-size plugin provides the `_size` meta field which, when enabled,
|
The mapper-size plugin provides the `_size` metadata field which, when enabled,
|
||||||
indexes the size in bytes of the original
|
indexes the size in bytes of the original
|
||||||
{ref}/mapping-source-field.html[`_source`] field.
|
{ref}/mapping-source-field.html[`_source`] field.
|
||||||
|
|
||||||
|
|
|
@ -10,7 +10,7 @@ The core mapper plugins are:
|
||||||
|
|
||||||
<<mapper-size>>::
|
<<mapper-size>>::
|
||||||
|
|
||||||
The mapper-size plugin provides the `_size` meta field which, when enabled,
|
The mapper-size plugin provides the `_size` metadata field which, when enabled,
|
||||||
indexes the size in bytes of the original
|
indexes the size in bytes of the original
|
||||||
{ref}/mapping-source-field.html[`_source`] field.
|
{ref}/mapping-source-field.html[`_source`] field.
|
||||||
|
|
||||||
|
|
|
@ -4,7 +4,7 @@
|
||||||
The purpose of this processor is to point documents to the right time based index based
|
The purpose of this processor is to point documents to the right time based index based
|
||||||
on a date or timestamp field in a document by using the <<date-math-index-names, date math index name support>>.
|
on a date or timestamp field in a document by using the <<date-math-index-names, date math index name support>>.
|
||||||
|
|
||||||
The processor sets the `_index` meta field with a date math index name expression based on the provided index name
|
The processor sets the `_index` metadata field with a date math index name expression based on the provided index name
|
||||||
prefix, a date or timestamp field in the documents being processed and the provided date rounding.
|
prefix, a date or timestamp field in the documents being processed and the provided date rounding.
|
||||||
|
|
||||||
First, this processor fetches the date or timestamp from a field in the document being processed. Optionally,
|
First, this processor fetches the date or timestamp from a field in the document being processed. Optionally,
|
||||||
|
|
|
@ -15,10 +15,10 @@ are stored and indexed. For instance, use mappings to define:
|
||||||
|
|
||||||
A mapping definition has:
|
A mapping definition has:
|
||||||
|
|
||||||
<<mapping-fields,Meta-fields>>::
|
<<mapping-fields,Metadata fields>>::
|
||||||
|
|
||||||
Meta-fields are used to customize how a document's associated metadata is
|
Metadata fields are used to customize how a document's associated metadata is
|
||||||
treated. Examples of meta-fields include the document's
|
treated. Examples of metadata fields include the document's
|
||||||
<<mapping-index-field,`_index`>>, <<mapping-id-field,`_id`>>, and
|
<<mapping-index-field,`_index`>>, <<mapping-id-field,`_id`>>, and
|
||||||
<<mapping-source-field,`_source`>> fields.
|
<<mapping-source-field,`_source`>> fields.
|
||||||
|
|
||||||
|
|
|
@ -1,12 +1,12 @@
|
||||||
[[mapping-fields]]
|
[[mapping-fields]]
|
||||||
== Meta-Fields
|
== Metadata fields
|
||||||
|
|
||||||
Each document has metadata associated with it, such as the `_index`, mapping
|
Each document has metadata associated with it, such as the `_index`, mapping
|
||||||
<<mapping-type-field,`_type`>>, and `_id` meta-fields. The behaviour of some of these meta-fields
|
<<mapping-type-field,`_type`>>, and `_id` metadata fields. The behavior of
|
||||||
can be customised when a mapping type is created.
|
some of these metadata fields can be customized when a mapping type is created.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
=== Identity meta-fields
|
=== Identity metadata fields
|
||||||
|
|
||||||
[horizontal]
|
[horizontal]
|
||||||
<<mapping-index-field,`_index`>>::
|
<<mapping-index-field,`_index`>>::
|
||||||
|
@ -22,7 +22,7 @@ can be customised when a mapping type is created.
|
||||||
The document's ID.
|
The document's ID.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
=== Document source meta-fields
|
=== Document source metadata fields
|
||||||
|
|
||||||
<<mapping-source-field,`_source`>>::
|
<<mapping-source-field,`_source`>>::
|
||||||
|
|
||||||
|
@ -34,7 +34,7 @@ can be customised when a mapping type is created.
|
||||||
{plugins}/mapper-size.html[`mapper-size` plugin].
|
{plugins}/mapper-size.html[`mapper-size` plugin].
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
=== Indexing meta-fields
|
=== Indexing metadata fields
|
||||||
|
|
||||||
<<mapping-field-names-field,`_field_names`>>::
|
<<mapping-field-names-field,`_field_names`>>::
|
||||||
|
|
||||||
|
@ -46,14 +46,14 @@ can be customised when a mapping type is created.
|
||||||
<<ignore-malformed,`ignore_malformed`>>.
|
<<ignore-malformed,`ignore_malformed`>>.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
=== Routing meta-field
|
=== Routing metadata field
|
||||||
|
|
||||||
<<mapping-routing-field,`_routing`>>::
|
<<mapping-routing-field,`_routing`>>::
|
||||||
|
|
||||||
A custom routing value which routes a document to a particular shard.
|
A custom routing value which routes a document to a particular shard.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
=== Other meta-field
|
=== Other metadata field
|
||||||
|
|
||||||
<<mapping-meta-field,`_meta`>>::
|
<<mapping-meta-field,`_meta`>>::
|
||||||
|
|
||||||
|
|
|
@ -20,7 +20,7 @@ Each mapping type could have its own fields, so the `user` type might have a
|
||||||
`tweet` type could have a `content` field, a `tweeted_at` field and, like the
|
`tweet` type could have a `content` field, a `tweeted_at` field and, like the
|
||||||
`user` type, a `user_name` field.
|
`user` type, a `user_name` field.
|
||||||
|
|
||||||
Each document had a `_type` meta-field containing the type name, and searches
|
Each document had a `_type` metadata field containing the type name, and searches
|
||||||
could be limited to one or more types by specifying the type name(s) in the
|
could be limited to one or more types by specifying the type name(s) in the
|
||||||
URL:
|
URL:
|
||||||
|
|
||||||
|
|
|
@ -11,13 +11,13 @@
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
[[all-meta-field-removed]]
|
[[all-meta-field-removed]]
|
||||||
==== The `_all` meta field is removed
|
==== The `_all` metadata field is removed
|
||||||
|
|
||||||
The `_all` field deprecated in 6 have now been removed.
|
The `_all` field deprecated in 6 have now been removed.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
[[uid-meta-field-removed]]
|
[[uid-meta-field-removed]]
|
||||||
==== The `_uid` meta field is removed
|
==== The `_uid` metadata field is removed
|
||||||
|
|
||||||
This field used to index a composite key formed of the `_type` and the `_id`.
|
This field used to index a composite key formed of the `_type` and the `_id`.
|
||||||
Now that indices cannot have multiple types, this has been removed in favour
|
Now that indices cannot have multiple types, this has been removed in favour
|
||||||
|
|
|
@ -9,7 +9,7 @@ By default, Elasticsearch sorts matching search results by **relevance
|
||||||
score**, which measures how well each document matches a query.
|
score**, which measures how well each document matches a query.
|
||||||
|
|
||||||
The relevance score is a positive floating point number, returned in the
|
The relevance score is a positive floating point number, returned in the
|
||||||
`_score` meta-field of the <<search-request-body,search>> API. The higher the
|
`_score` metadata field of the <<search-request-body,search>> API. The higher the
|
||||||
`_score`, the more relevant the document. While each query type can calculate
|
`_score`, the more relevant the document. While each query type can calculate
|
||||||
relevance scores differently, score calculation also depends on whether the
|
relevance scores differently, score calculation also depends on whether the
|
||||||
query clause is run in a **query** or **filter** context.
|
query clause is run in a **query** or **filter** context.
|
||||||
|
@ -20,7 +20,7 @@ query clause is run in a **query** or **filter** context.
|
||||||
In the query context, a query clause answers the question ``__How well does this
|
In the query context, a query clause answers the question ``__How well does this
|
||||||
document match this query clause?__'' Besides deciding whether or not the
|
document match this query clause?__'' Besides deciding whether or not the
|
||||||
document matches, the query clause also calculates a relevance score in the
|
document matches, the query clause also calculates a relevance score in the
|
||||||
`_score` meta-field.
|
`_score` metadata field.
|
||||||
|
|
||||||
Query context is in effect whenever a query clause is passed to a `query`
|
Query context is in effect whenever a query clause is passed to a `query`
|
||||||
parameter, such as the `query` parameter in the
|
parameter, such as the `query` parameter in the
|
||||||
|
|
|
@ -14,7 +14,7 @@ API will have access to the `ctx` variable which exposes:
|
||||||
[horizontal]
|
[horizontal]
|
||||||
`ctx._source`:: Access to the document <<mapping-source-field,`_source` field>>.
|
`ctx._source`:: Access to the document <<mapping-source-field,`_source` field>>.
|
||||||
`ctx.op`:: The operation that should be applied to the document: `index` or `delete`.
|
`ctx.op`:: The operation that should be applied to the document: `index` or `delete`.
|
||||||
`ctx._index` etc:: Access to <<mapping-fields,document meta-fields>>, some of which may be read-only.
|
`ctx._index` etc:: Access to <<mapping-fields,document metadata fields>>, some of which may be read-only.
|
||||||
|
|
||||||
[discrete]
|
[discrete]
|
||||||
== Search and aggregation scripts
|
== Search and aggregation scripts
|
||||||
|
|
|
@ -211,7 +211,7 @@ returns this response:
|
||||||
// TESTRESPONSE[s/"took": 2,/"took": "$body.took",/]
|
// TESTRESPONSE[s/"took": 2,/"took": "$body.took",/]
|
||||||
|
|
||||||
|
|
||||||
IMPORTANT: `_source` meta-field must be enabled, which is the default
|
IMPORTANT: `_source` metadata field must be enabled, which is the default
|
||||||
behavior, to enable returning `_source` with suggestions.
|
behavior, to enable returning `_source` with suggestions.
|
||||||
|
|
||||||
The configured weight for a suggestion is returned as `_score`. The
|
The configured weight for a suggestion is returned as `_score`. The
|
||||||
|
|
|
@ -30,9 +30,9 @@ POST /_security/role/test_role1
|
||||||
}
|
}
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
|
|
||||||
Access to the following meta fields is always allowed: `_id`,
|
Access to the following metadata fields is always allowed: `_id`,
|
||||||
`_type`, `_parent`, `_routing`, `_timestamp`, `_ttl`, `_size` and `_index`. If
|
`_type`, `_parent`, `_routing`, `_timestamp`, `_ttl`, `_size` and `_index`. If
|
||||||
you specify an empty list of fields, only these meta fields are accessible.
|
you specify an empty list of fields, only these metadata fields are accessible.
|
||||||
|
|
||||||
NOTE: Omitting the fields entry entirely disables field level security.
|
NOTE: Omitting the fields entry entirely disables field level security.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue