Skip to content

Commit ded0e04

Browse files
committed
Update reading-indices-from-older-elasticsearch-versions.md
1 parent 434a00d commit ded0e04

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

deploy-manage/upgrade/deployment-or-cluster/reading-indices-from-older-elasticsearch-versions.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,51 +5,51 @@ mapped_pages:
55

66
# Reading indices from older {{es}} versions [archive-indices]
77

8-
{{es}} has full query and write support for indices created in the previous major version. If you have indices created in {{es}} version 7, you can now use the archive functionality to import them into newer {{es}} versions as well.
8+
{{es}} has full query and write support for indices created in the previous major version. If you have indices created in {{es}} versions 5, 6, or 7, you can now use the archive functionality to import them into newer {{es}} versions as well.
99

1010
The archive functionality provides slower read-only access to older {{es}} data, for compliance or regulatory reasons, the occasional lookback or investigation, or to rehydrate parts of it. Access to the data is expected to be infrequent, and can therefore happen with limited performance and query capabilities.
1111

12-
For this, {{es}} has the ability to access older snapshot repositories. The legacy indices in the [snapshot repository](../../tools/snapshot-and-restore.md) can either be [restored](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-restore), or directly accessed through [searchable snapshots](../../tools/snapshot-and-restore/searchable-snapshots.md) so that the archived data won’t need to fully reside on local disks for access.
12+
For this, {{es}} can access older snapshot repositories going back to version 5. The legacy indices in the [snapshot repository](../../tools/snapshot-and-restore.md) can either be [restored](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-restore) or directly accessed through [searchable snapshots](../../tools/snapshot-and-restore/searchable-snapshots.md) so that the archived data won’t need to fully reside on local disks for access.
1313

1414

1515
## Supported field types [archive-indices-supported-field-types]
1616

17-
Old mappings are imported as much "as-is" as possible into {{es}} 8, but only provide regular query capabilities on a select subset of fields:
17+
Old mappings are imported as much as possible into {{es}} 9, but only provide regular query capabilities on a select subset of fields:
1818

1919
* [Numeric types](elasticsearch://reference/elasticsearch/mapping-reference/number.md)
2020
* [`boolean` type](elasticsearch://reference/elasticsearch/mapping-reference/boolean.md)
2121
* [`ip` type](elasticsearch://reference/elasticsearch/mapping-reference/ip.md)
2222
* [`geo_point` type](elasticsearch://reference/elasticsearch/mapping-reference/geo-point.md)
23-
* [`date` types](elasticsearch://reference/elasticsearch/mapping-reference/date.md): the date `format` setting on date fields is supported as long as it behaves similarly across these versions. In case it is not, for example [when using custom date formats](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/migrate-to-java-time.html), this field can be updated on legacy indices so that it can be changed by a user if need be.
24-
* [`keyword` type](elasticsearch://reference/elasticsearch/mapping-reference/keyword.md#keyword-field-type): the `normalizer` setting on keyword fields is supported as long as it behaves similarly across these versions. In case it is not, this field can be updated on legacy indices if need be.
25-
* [`text` type](elasticsearch://reference/elasticsearch/mapping-reference/text.md#text-field-type): scoring capabilities are limited, and all queries return constant scores that are equal to 1.0. The `analyzer` settings on text fields are supported as long as they behave similarly across these versions. In case they do not, they can be updated on legacy indices if need be.
23+
* [`date` types](elasticsearch://reference/elasticsearch/mapping-reference/date.md): the date `format` setting on date fields is supported as long as it behaves similarly across these versions. If it is not, for example, [when using custom date formats](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/migrate-to-java-time.html), this field can be updated on legacy indices so a user can change it if needed.
24+
* [`keyword` type](elasticsearch://reference/elasticsearch/mapping-reference/keyword.md#keyword-field-type): The `normalizer` setting on keyword fields is supported as long as it behaves similarly across these versions. If they do not, they can be updated on legacy indices if necessary.
25+
* [`text` type](elasticsearch://reference/elasticsearch/mapping-reference/text.md#text-field-type): Scoring capabilities are limited, and all queries return constant scores equal to 1.0. The `analyzer` settings on text fields are supported as long as they behave similarly across these versions. If they don't, they can be updated on legacy indices.
2626
* [Multi-fields](elasticsearch://reference/elasticsearch/mapping-reference/multi-fields.md)
2727
* [Field aliases](elasticsearch://reference/elasticsearch/mapping-reference/field-alias.md)
2828
* [`object`](elasticsearch://reference/elasticsearch/mapping-reference/object.md) fields
29-
* some basic metadata fields, such `_type` for querying {{es}} 7 indices
29+
* some basic metadata fields, such as `_type` for querying {{es}} 5 indices
3030
* [runtime fields](../../../manage-data/data-store/mapping/map-runtime-field.md)
3131
* [`_source` field](elasticsearch://reference/elasticsearch/mapping-reference/mapping-source-field.md)
3232

33-
{{es}} 7 indices with mappings that have [multiple mapping types](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/removal-of-types.html) are collapsed together on a best-effort basis before they are imported.
33+
{{es}} 5 indices with mappings that have [multiple mapping types](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/removal-of-types.html) are collapsed together on a best-effort basis before being imported.
3434

35-
In case the auto-import of mappings does not work, or the new {{es}} version can’t make sense of the mapping, it falls back to importing the index without the mapping, but stores the original mapping in the [_meta](elasticsearch://reference/elasticsearch/mapping-reference/mapping-meta-field.md) section of the imported index. The legacy mapping can then be introspected using the [GET mapping](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-mapping) API and an updated mapping can be manually put in place using the [update mapping](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-mapping) API, copying and adapting relevant sections of the legacy mapping to work with the current {{es}} version. While auto-import is expected to work in most cases, failures of doing so should be [raised](https://github.com/elastic/elasticsearch/issues/new/choose) with the Elastic team for future improvements.
35+
If auto-importing mappings does not work, or the new {{es}} version doesn't understand the mapping, it falls back to importing the index without the mapping, but stores the original mapping in the [_meta](elasticsearch://reference/elasticsearch/mapping-reference/mapping-meta-field.md) section of the imported index. Users can then examine the legacy mapping using the [GET mapping](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-mapping) API, and manually update the mapping using the [update mapping](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-mapping) API, copying and adapting relevant sections of the legacy mapping to work with the current {{es}} version. While auto-import is expected to work in most cases, any failures should be [raised](https://github.com/elastic/elasticsearch/issues/new/choose) with the Elastic team for future improvements.
3636

3737

3838
## Supported APIs [_supported_apis]
3939

40-
Archive indices are read-only, and provide data access through the [search](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search) and [field capabilities](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-field-caps) APIs. They do not support the [Get API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-get) nor any write APIs.
40+
Archive indices are read-only and provide data access through the [search](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search) and [field capabilities](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-field-caps) APIs. They do not support the [Get API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-get) or any write APIs.
4141

42-
Archive indices allow running queries as well as aggregations as long as they are [supported by the given field type](#archive-indices-supported-field-types).
42+
Archive indices allow running queries and aggregations if the [field type](#archive-indices-supported-field-types) supports them.
4343

44-
Due to `_source` access, the data can also be [reindexed](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex) to a new index that has full compatibility with the current {{es}} version.
44+
Due to `_source` access, the data can also be [reindexed](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex) to a new index that's fully compatible with the current {{es}} version.
4545

4646

47-
## Upgrade older {{es}} 7 clusters [_how_to_upgrade_older_es_7_clusters]
47+
## Upgrade older {{es}} clusters [_how_to_upgrade_older_es_clusters]
4848

49-
To upgrade older {{es}} 7 clusters:
49+
To upgrade older {{es}} 5, 6, or 7 clusters:
5050

5151
1. Take a snapshot of the indices in the old cluster.
52-
2. Delete any indices that were created before 8.0.0.
52+
2. Delete any indices created before 8.0.0.
5353
3. Upgrade the cluster without the old indices, then [restore](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-restore) the legacy indices from the snapshot or [mount](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-searchable-snapshots-mount) them using searchable snapshots.
5454

5555
% In the future, we plan on streamlining the upgrade process going forward, making it easier to take legacy indices along when going to future major {{es}} versions.

0 commit comments

Comments
 (0)