Pular para o conteúdo
Skillpedia
Bancos de dados40 mil · #5309

qdrant-horizontal-scaling

Ajuda seu agente a decidir como adicionar mais nós ao Qdrant. Use quando você precisa de mais capacidade ou os dados estão crescendo muito.

O que ela faz

Ajuda você a decidir se deve expandir seu banco de dados Qdrant adicionando mais máquinas (horizontal) ou melhorando a máquina atual (vertical). Orienta sobre quantos nós e fragmentos usar para um bom desempenho e confiabilidade.

Quando usar

  • ✓Quando seus dados crescem muito para uma única máquina.
  • ✓Se você precisa que seu sistema continue funcionando mesmo se uma máquina falhar.
  • ✓Para dividir seus dados e usuários em grupos menores para melhor gerenciamento.

Exemplo do que pedir para a IA

“Meus dados não cabem mais em uma máquina, devo adicionar mais máquinas ou melhorar a atual? Quantos nós e fragmentos devo usar?”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/github/awesome-copilot/blob/main/skills/qdrant-scaling/scaling-data-volume/horizontal-scaling/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/github/awesome-copilot/blob/main/skills/qdrant-scaling/scaling-data-volume/horizontal-scaling/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

Esta ferramenta analisa se você precisa de mais capacidade e sugere a melhor forma de expandir seu Qdrant. Ela considera se você deve adicionar mais máquinas ou melhorar a existente, e recomenda a quantidade ideal de fragmentos e réplicas para garantir que seus dados estejam seguros e acessíveis.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add github/awesome-copilot --skill qdrant-horizontal-scaling

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-scaling/scaling-data-volume/horizontal-scaling/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

O que fazer quando o Qdrant precisa de mais capacidade

Vertical primeiro: operações mais simples, sem sobrecarga de rede, bom para até ~100 milhões de vetores por nó, dependendo das dimensões e quantização. Horizontal quando: os dados excedem a capacidade de um único nó, é necessária tolerância a falhas, é necessário isolar inquilinos ou há gargalo de IOPS (mais nós = mais IOPS independentes).

Configuração distribuída mais básica

  • 3 nós, 3 shards com replication_factor: 2 para escalabilidade sem tempo de inatividade

Um mínimo de 3 nós é importante para consenso e tolerância a falhas. Com 3 nós, você pode perder 1 nó sem tempo de inatividade. Com 2 nós, perder 1 nó causa tempo de inatividade para operações de coleção. Um fator de replicação de 2 significa que cada shard tem 1 réplica, então você tem 2 cópias dos dados. Isso permite escalabilidade e manutenção sem tempo de inatividade. Com replication_factor: 1, o tempo de inatividade zero não é garantido mesmo para operações em nível de ponto, e a manutenção do cluster requer tempo de inatividade.

Escolhendo o número de shards

Shards são a unidade de distribuição de dados. Mais shards permitem mais nós e melhor distribuição, mas adicionam sobrecarga. Menos shards reduzem a sobrecarga, mas limitam a escalabilidade horizontal.

Para um cluster de 3 a 6 nós, o número recomendado de shards é de 6 a 12. Isso permite 2 a 4 shards por nó, o que equilibra distribuição e sobrecarga.

Alterando o número de shards

Use quando: o número de shards não é divisível igualmente pelo número de nós, causando distribuição desigual, ou quando é necessário rebalancear.

O rebalanceamento de shards é caro e demorado, devendo ser usado como último recurso se a distribuição regular de dados não for possível. O rebalanceamento de shards é projetado para ser transparente para as operações do usuário; atualizações e buscas devem continuar funcionando durante o rebalanceamento, com um pequeno impacto no desempenho.

Mas a operação de rebalanceamento de shards em si é demorada e requer a movimentação de grandes quantidades de dados entre os nós.

  • Disponível no Qdrant Cloud Rebalanceamento de Shards
  • O rebalanceamento de shards não está disponível para implantações auto-hospedadas.

Melhores alternativas: pré-provisionar shards inicialmente ou iniciar um novo cluster com a configuração correta e migrar os dados.

O que NÃO fazer

  • Não pule para o horizontal antes de esgotar o vertical (adiciona complexidade sem ganho)
  • Não defina shard_number que não seja um múltiplo do número de nós (distribuição desigual)
  • Não use replication_factor: 1 em produção se precisar de tolerância a falhas
  • Não adicione nós sem rebalancear shards (use a API de movimentação de shards para redistribuir)
  • Não reduza a RAM sem testes de carga (a evacuação do cache causa incidentes de latência de dias)
  • Não atinja o limite de coleção usando uma coleção por inquilino (use particionamento de payload)
Perguntas frequentes

O que é escalonamento horizontal?

É quando você adiciona mais máquinas (nós) para distribuir a carga de trabalho e os dados, em vez de apenas melhorar uma única máquina.

Por que 3 nós é o mínimo recomendado?

Com 3 nós, o sistema pode continuar funcionando mesmo que uma máquina falhe. Com apenas 2, perder uma máquina causa interrupções.

O que são fragmentos (shards) e réplicas?

Fragmentos são partes dos seus dados. Réplicas são cópias desses fragmentos. Ter várias cópias (replicação) garante que seus dados não sejam perdidos e que o sistema continue funcionando se uma máquina falhar.

Detalhes

Descrição original do autor

Diagnoses and guides Qdrant horizontal scaling decisions. Use when someone asks 'vertical or horizontal?', 'how many nodes?', 'how many shards?', 'how to add nodes', 'resharding', 'data doesn't fit', or 'need more capacity'. Also use when data growth outpaces current deployment.

repo: github/awesome-copilot

Popularidade

Estrelas no GitHub
40 mil
Posição no ranking
#5309
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas