O mundo dos bancos de dados NoSQL oferece uma variedade de soluções para atender às necessidades de aplicações modernas que exigem alta performance, escalabilidade e disponibilidade. Dentro desse cenário, o Redis (e agora o Valkey, seu fork de código aberto) se destaca como um poderoso banco de dados em memória que suporta diversas estruturas de dados e funcionalidades avançadas, como o clustering.

A arquitetura de cluster do Redis/Valkey permite distribuir dados entre múltiplos nós, aumentando a capacidade de armazenamento e processamento. A chave para essa distribuição eficiente é o particionamento dos dados através de *slots*. Cada chave é mapeada para um slot específico, e cada slot é atribuído a um nó master dentro do cluster. É aqui que o comando `CLUSTER ADDSLOTSRANGE` entra em cena, desempenhando um papel crucial na inicialização e configuração do seu cluster.

O Que é o `CLUSTER ADDSLOTSRANGE`?

O comando `CLUSTER ADDSLOTSRANGE` é uma das ferramentas fundamentais para gerenciar a alocação de slots em um cluster Redis/Valkey. Especificamente, ele permite atribuir um *range* (intervalo) de slots a um determinado nó master. A sintaxe básica é:

CLUSTER ADDSLOTSRANGE slot1 slot2 … slotN

Onde `slot1`, `slot2`, …, `slotN` representam o intervalo de slots que você deseja atribuir ao nó em questão. É importante lembrar que o Redis/Valkey utiliza um total de 16384 slots de hash (numerados de 0 a 16383).

Por Que Usar `CLUSTER ADDSLOTSRANGE`?

Como mencionado na introdução, o comando `CLUSTER ADDSLOTSRANGE` (e seu irmão, `CLUSTER ADDSLOTS`) são *essenciais* durante a criação inicial de um cluster Redis/Valkey a partir do zero. O processo de inicialização de um cluster envolve os seguintes passos principais:

1. Iniciar os nós: Inicie cada instância do Redis/Valkey que fará parte do cluster. Configure cada nó para rodar em modo cluster (geralmente através da opção `cluster-enabled yes` no arquivo de configuração).

2. Conectar os nós: Conecte os nós entre si para que eles possam descobrir uns aos outros e formar o cluster. Isso pode ser feito manualmente usando o comando `CLUSTER MEET` ou, mais comumente, através de scripts de inicialização automatizados.

3. Atribuir slots: Atribua faixas de slots a cada nó master. É aqui que o `CLUSTER ADDSLOTSRANGE` se torna crucial. Você deve garantir que todos os 16384 slots sejam atribuídos a algum nó master dentro do cluster.

4. Definir réplicas: Para cada nó master, você pode designar um ou mais nós réplica. As réplicas replicam os dados do master e atuam como backups em caso de falha do master.

5. Distribuir os dados: Uma vez que o cluster esteja configurado e os slots atribuídos, você pode começar a escrever dados no cluster. O Redis/Valkey automaticamente roteará as chaves para o nó correto com base no slot de hash.

Exemplo Prático de Uso

Vamos supor que você esteja criando um cluster Redis/Valkey com 3 nós master. Uma estratégia comum é dividir os slots de forma aproximadamente igual entre os nós. Você pode usar o `CLUSTER ADDSLOTSRANGE` da seguinte forma:

* Nó Master 1: `CLUSTER ADDSLOTSRANGE 0 5460` (Atribui os slots de 0 a 5460)

* Nó Master 2: `CLUSTER ADDSLOTSRANGE 5461 10922` (Atribui os slots de 5461 a 10922)

* Nó Master 3: `CLUSTER ADDSLOTSRANGE 10923 16383` (Atribui os slots de 10923 a 16383)