org.elasticsearch.cluster.metadata

Class MetaDataIndexUpgradeService

java.lang.Object

org.elasticsearch.common.component.AbstractComponent

org.elasticsearch.cluster.metadata.MetaDataIndexUpgradeService

public class MetaDataIndexUpgradeService
extends AbstractComponent

This service is responsible for upgrading legacy index metadata to the current version

Every time an existing index is introduced into cluster this service should be used to upgrade the existing index metadata to the latest version of the cluster. It typically occurs during cluster upgrade, when dangling indices are imported into the cluster or indices are restored from a repository.

Field Summary

Fields inherited from class org.elasticsearch.common.component.AbstractComponent

deprecationLogger, logger, settings

Constructor Summary

Constructors

Constructor and Description
MetaDataIndexUpgradeService(Settings settings, NamedXContentRegistry xContentRegistry, MapperRegistry mapperRegistry, IndexScopedSettings indexScopedSettings, java.util.Collection<java.util.function.UnaryOperator<IndexMetaData>> indexMetaDataUpgraders)

Method Summary

Modifier and Type	Method and Description
IndexMetaData	upgradeIndexMetaData(IndexMetaData indexMetaData, Version minimumIndexCompatibilityVersion) Checks that the index can be upgraded to the current version of the master node.

Methods inherited from class org.elasticsearch.common.component.AbstractComponent

logDeprecatedSetting, logRemovedSetting, nodeName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MetaDataIndexUpgradeService

@Inject
public MetaDataIndexUpgradeService(Settings settings,
                                           NamedXContentRegistry xContentRegistry,
                                           MapperRegistry mapperRegistry,
                                           IndexScopedSettings indexScopedSettings,
                                           java.util.Collection<java.util.function.UnaryOperator<IndexMetaData>> indexMetaDataUpgraders)

Method Detail

upgradeIndexMetaData

public IndexMetaData upgradeIndexMetaData(IndexMetaData indexMetaData,
                                          Version minimumIndexCompatibilityVersion)

Checks that the index can be upgraded to the current version of the master node.

If the index does not need upgrade it returns the index metadata unchanged, otherwise it returns a modified index metadata. If index cannot be updated the method throws an exception.