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
Mensagem pronta para colar
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-scalingOu 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.mdConteú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: 2para 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_numberque não seja um múltiplo do número de nós (distribuição desigual) - Não use
replication_factor: 1em 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
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
clickhouse-io
Ajuda seu agente a otimizar consultas e esquemas no banco de dados ClickHouse. Ele aplica as melhores práticas para cargas de trabalho analíticas de alta performance. Use quando consultas analíticas demoram muito.
affaan-m/ECC
scientific-db-pubmed-database
Ajuda seu agente a buscar artigos científicos na área biomédica. É útil para pesquisas que precisam de informações médicas específicas.
affaan-m/ECC
scientific-db-uspto-database
Permite ao agente consultar dados oficiais de patentes e marcas registradas dos EUA. É útil para pesquisas de propriedade intelectual.
affaan-m/ECC