Como mudar um mapping usando reindex e aliases?

Question

IT Interview Practice · Accepted Answer

Um alias é um nome estável que aponta para um índice. Quando um campo precisa de mudança incompatível de mapping, crie um novo índice e mova esse nome após verificar os dados copiados.

## Visualize a mudança

```text
Before: application -> products -> products-v1
After:  application -> products -> products-v2
```

A aplicação continua usando `products`. Primeiro crie `products-v2` com o mapping e as configurações desejadas. Reindex copia documentos; não copia automaticamente a configuração do índice de origem.

## Use uma migração simples quando puder pausar escritas

- Pause escritas da aplicação, inclusive processos em segundo plano, mantendo leituras disponíveis quando adequado.
- Reindexe v1 em v2, examine falhas e verifique documentos e consultas representativos após tornar os dados copiados pesquisáveis.
- Altere o alias, teste leituras e escritas da aplicação e retome os escritores.

Para um alias que atualmente aponta só para v1, esta requisição no Kibana Dev Tools faz a troca em uma única atualização de alias:

```http
POST /_aliases
{
  "actions": [
    {"remove":{"index":"products-v1","alias":"products","must_exist":true}},
    {"add":{"index":"products-v2","alias":"products","is_write_index":true}}
  ]
}
```

Examine a resposta antes de retomar as escritas. Isso evita um intervalo entre remoção e adição separadas; não copia alterações perdidas durante a migração.

## Quando as escritas não podem parar

Você precisa de um registro durável das mudanças feitas durante a cópia e de uma maneira de reaplicar atualizações e exclusões sem dados antigos sobrescreverem novos. Esse é um projeto separado de sincronização. Mantenha v1 temporariamente, mas não presuma que voltar a ele será sem perdas depois de novas escritas chegarem a v2.

[Documentação oficial](https://www.elastic.co/docs/manage-data/data-store/aliases).

Visualize a mudança

Use uma migração simples quando puder pausar escritas

Quando as escritas não podem parar

Perguntas relacionadas