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

qdrant-scaling-qps

Ajuda seu agente a fazer o Qdrant responder mais rápido a buscas. É útil quando você precisa processar muitas consultas por segundo.

O que ela faz

Este guia ajuda a aumentar a quantidade de buscas que o Qdrant consegue fazer por segundo. Ele foca em otimizar o sistema para lidar com mais requisições simultâneas, o que é diferente de fazer cada busca individualmente mais rápida.

Quando usar

  • ✓Quando você precisa que seu sistema responda a mais buscas ao mesmo tempo.
  • ✓Se as buscas estão lentas porque muitas pessoas estão usando o sistema de uma vez.
  • ✓Ao configurar o Qdrant para lidar com um grande volume de requisições.

Exemplo do que pedir para a IA

“Como faço para o Qdrant aguentar mais buscas por segundo?”

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-qps/SKILL.md

Mensagem pronta para colar

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

Para aumentar o número de buscas por segundo, você pode ajustar configurações para que o Qdrant use menos recursos em cada busca individual, como agrupar buscas ou usar menos partes do banco de dados por vez. Se isso não for suficiente, você pode adicionar mais máquinas para dividir o trabalho.

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-scaling-qps

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-scaling/scaling-qps/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.

Escalando para Vazão de Consultas (QPS)

Escalar a vazão significa lidar com mais consultas paralelas por segundo. Isso é diferente de latência - vazão e latência são direções de ajuste opostas e não podem ser otimizadas simultaneamente no mesmo nó.

Alta vazão favorece segmentos menores e mais numerosos para que cada consulta toque menos sobrecarga.

Ajuste de Desempenho para RPS Mais Alto

  • Use menos segmentos, maiores (default_segment_number: 2) Maximizando a vazão
  • Habilite a quantização com always_ram=true para reduzir o IO de disco Quantização
  • Use a API de busca em lote para amortizar a sobrecarga Busca em lote

Minimizar o Impacto de Cargas de Trabalho de Atualização

  • Configure o controle de vazão de atualização (v1.17+) para evitar que buscas não otimizadas degradem leituras Busca de baixa latência
  • Defina optimizer_cpu_budget para limitar as CPUs de indexação (por exemplo, 2 em um nó de 8 CPUs reserva 6 para consultas)
  • Configure o fan-out de leitura atrasado (v1.17+) para latência de cauda Fan-outs atrasados

Escala Horizontal para Vazão

Se um único nó estiver saturado de CPU após aplicar o ajuste acima, escale horizontalmente com réplicas de leitura.

  • Réplicas de shard atendem consultas de shards replicados, distribuindo a carga de leitura entre os nós
  • Cada réplica adiciona capacidade de consulta independente sem re-shard
  • Use replication_factor: 2+ e direcione leituras para réplicas Implantação distribuída

Veja também Escala Horizontal para orientação geral sobre escala horizontal.

Gargalos de I/O de Disco

Se não for possível manter todos os vetores na RAM, o I/O de disco pode se tornar o gargalo para a vazão. Neste caso:

  • Atualize para IOPS provisionado ou NVMe local primeiro. Veja o impacto do desempenho do disco na busca de vetores no artigo de desempenho de disco
  • Use io_uring no Linux (kernel 5.11+) artigo io_uring
  • No caso de vetores quantizados, prefira o re-scoring global em vez do re-scoring por segmento para reduzir leituras de disco. Exemplo no tutorial
  • Configure um número maior de threads de busca para paralelizar leituras de disco. O padrão é cpu_count - 1, que é ideal para busca baseada em RAM, mas pode ser muito baixo para busca baseada em disco. Veja referência de configuração
  • Se ainda saturado, escale horizontalmente (cada nó adiciona IOPS independentes)

O Que NÃO Fazer

  • Não espere otimizar vazão e latência simultaneamente no mesmo nó
  • Não use muitos segmentos pequenos para cargas de trabalho de vazão (aumenta a sobrecarga por consulta)
  • Não escale horizontalmente quando limitado por IOPS sem também atualizar o nível do disco
  • Não execute com mais de 90% de RAM (evicção de cache do SO = degradação severa de desempenho)
Perguntas frequentes

Qual a diferença entre velocidade da busca (latência) e quantidade de buscas por segundo (throughput)?

Latência é o tempo que uma única busca leva para ser respondida. Throughput é quantas buscas o sistema consegue responder em um segundo. Otimizar um pode piorar o outro.

O que são 'segmentos' e por que ter menos é melhor para mais buscas por segundo?

Segmentos são como arquivos onde os dados são organizados. Ter menos segmentos, mas maiores, significa que o Qdrant precisa acessar menos arquivos para cada busca, o que é mais eficiente quando o objetivo é responder a muitas buscas rapidamente.

O que é 'escala horizontal'?

Escala horizontal significa adicionar mais máquinas (ou instâncias do Qdrant) para distribuir o trabalho. Isso é útil quando uma única máquina não consegue mais lidar com todas as requisições, mesmo após otimizações.

Detalhes

Descrição original do autor

Guides Qdrant query throughput (QPS) scaling. Use when someone asks 'how to increase QPS', 'need more throughput', 'queries per second too low', 'batch search', 'read replicas', or 'how to handle more concurrent queries'.

repo: github/awesome-copilot

Popularidade

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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas