Todos os produtos
Search
Central de documentação

Elasticsearch:Recurso de replicação física do Apack

Última atualização: Jun 27, 2026

A replicação física reduz a sobrecarga de CPU e melhora o desempenho de gravação em mais de 45% para cargas de trabalho intensivas em escrita com shards de réplica. Esse recurso é ideal para casos de uso que toleram atrasos na visibilidade dos dados na faixa de milissegundos, como logging e análise de séries temporais.

O plug-in apack fornece esse recurso. Desenvolvido pela Alibaba Cloud, ele vem instalado por padrão em instâncias do Alibaba Cloud Elasticsearch versão 6.7.0 (kernel 1.2.0 ou posterior) ou 7.10.0 e não pode ser desinstalado. Para verificar o status da instalação, acesse a página Plug-ins. Execute todos os comandos deste tópico no console do Kibana. Para mais informações, consulte Conectar-se a um cluster usando o Kibana.

Como funciona

Na replicação nativa, tanto o shard primário quanto os shards de réplica gravam no arquivo de índice e no translog.

Com a replicação física ativada:

  • O shard primário grava tanto no arquivo de índice quanto no translog (sem alterações).

  • O shard de réplica grava apenas no translog.

  • A cada refresh, o shard primário copia arquivos de índice incrementais para o shard de réplica pela rede.

Esse mecanismo transfere a carga de indexação dos shards de réplica, mas aumenta o uso de rede no shard primário. O atraso na visibilidade dos dados entre os shards primários e de réplica permanece na faixa de milissegundos.

Physical replication diagram

Considerações

Antes de ativar a replicação física, observe os pontos abaixo:

  • Uso de rede: A replicação física aumenta a carga de rede nos shards primários, pois o shard primário precisa copiar arquivos de índice para todos os shards de réplica durante cada refresh.

  • Incompatibilidade com Cross-Cluster Replication (CCR): Se você planeja usar a Cross-Cluster Replication (CCR) para recuperação de desastres, desative primeiro a replicação física. Os dois recursos não podem ser usados simultaneamente.

  • Atraso na visibilidade dos dados: Os dados do shard de réplica tornam-se visíveis milissegundos após o refresh do shard primário, e não imediatamente após a indexação. Isso é aceitável para logging e análise de séries temporais, mas pode não atender a casos de uso que exigem consistência de leitura após escrita.

Ativar a replicação física para um novo índice

A replicação física é ativada por padrão para índices criados após a instalação do plug-in apack. Nenhuma configuração manual é necessária.

Para ativá-la explicitamente ao criar um índice, defina index.replication.type como segment:

PUT index-1
{
  "settings": {
    "index.replication.type" : "segment"
  }
}

Para ativar a replicação física em um índice existente no modo de replicação nativa, consulte Ativar a replicação física para um índice existente.

Desativar a replicação física

Ao desativar a replicação física, o índice retorna ao modo de replicação nativa, no qual tanto o shard primário quanto os shards de réplica gravam no arquivo de índice e no translog.

Importante

Desative a replicação física antes de usar a Cross-Cluster Replication (CCR) para recuperação de desastres. Para mais informações, consulte Usar Cross-Cluster Replication (CCR) para recuperação de desastres.

  1. Feche o índice.

    POST index-1/_close
  2. Atualize as configurações do índice para desativar a replicação física.

    PUT index-1/_settings
    {
      "index.replication.type" : null
    }
  3. Abra o índice.

    POST index-1/_open

Ativar a replicação física para um índice existente

Para ativar a replicação física em um índice existente no modo de replicação nativa, defina a contagem de réplicas como 0 e feche o índice.

  1. Defina o número de réplicas como 0.

    PUT index-1/_settings
    {
      "index.number_of_replicas": 0
    }
  2. Feche o índice.

    POST index-1/_close
  3. Atualize as configurações do índice para ativar a replicação física.

    PUT index-1/_settings
    {
      "index.replication.type" : "segment"
    }
  4. Abra o índice.

    POST index-1/_open
  5. Restaure a contagem de réplicas.

    PUT index-1/_settings
    {
      "index.number_of_replicas": 1
    }