› › ›

Поля метаданных ES|QL

ES|QL может получать доступ к полям метаданных. В настоящее время поддерживаются следующие поля:

_index: индекс, к которому принадлежит документ. Тип поля — keyword.
_id: идентификатор исходного документа. Тип поля — keyword.
_version: версия исходного документа. Тип поля — long.
_ignored: поля исходного документа, которые игнорируются. Тип поля — keyword.

Для включения доступа к этим полям, команде источника FROM необходимо указать специальную директиву:

FROM index METADATA _index, _id

Поля метаданных доступны только если источником данных является индекс. Следовательно, только FROM поддерживает директиву METADATA.

После активации, эти поля будут доступны для последующих команд обработки, подобно другим полям индекса:

FROM ul_logs, apps METADATA _index, _version
| WHERE id IN (13, 14) AND _version == 1
| EVAL key = CONCAT(_index, "_", TO_STR(id))
| SORT id, _index
| KEEP id, _index, _version, key

id:long	_index:keyword	_version:long	key:keyword
13	apps	1	apps_13
13	ul_logs	1	ul_logs_13
14	apps	1	apps_14
14	ul_logs	1	ul_logs_14

Подобно полям индекса, после выполнения агрегации, поле метаданных больше недоступно для последующих команд, если только оно не используется в качестве поля группировки:

FROM employees METADATA _index, _id
| STATS max = MAX(emp_no) BY _index

max:integer	_index:keyword
10100	employees

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/esql-metadata-fields.html