qdrant-tenant-scaling
Ajuda seu agente a gerenciar o Qdrant quando há muitos usuários. É útil para organizar dados e garantir que tudo funcione bem para cada um.
O que ela faz
Este guia ajuda a organizar seus dados no Qdrant quando você tem muitos usuários ou clientes (chamados de 'tenants'). Ele explica como separar os dados de cada um de forma eficiente para que tudo funcione rápido.
Quando usar
- ✓Quando você tem muitos clientes e quer organizar os dados deles.
- ✓Se os dados de um cliente estão lentos ou causando problemas para outros.
- ✓Quando você precisa garantir que os dados de um cliente não se misturem com os de outro.
Exemplo do que pedir para a IA
“Como posso organizar os dados de milhares de clientes no Qdrant para que tudo funcione bem?”
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
O Qdrant sugere usar filtros no 'payload' (informações extras dos dados) para separar os clientes em coleções compartilhadas. Para muitos clientes, ele recomenda dividir o trabalho em partes menores (shards) ou até ter partes dedicadas para clientes muito grandes ou que precisam de segurança extra.
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-tenant-scalingOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-scaling/scaling-data-volume/tenant-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 ao Escalar Qdrant Multi-Tenant
Não crie uma coleção por tenant. Isso não escala além de algumas centenas e desperdiça recursos. Uma empresa atingiu o limite de 1000 coleções após um ano de coleção-por-repositório e teve que migrar para particionamento por payload. Use uma coleção compartilhada com uma chave de tenant.
- Entenda os padrões de multitenancy Multitenancy
Aqui está um breve resumo dos padrões:
Número de Tenants é em torno de 10 mil
Use a estratégia de multitenancy padrão através de filtragem por payload.
Leia sobre Particionar por payload e Calibrar performance para melhores práticas em indexação e performance de consulta.
Número de Tenants é em torno de 100 mil e mais
Nessa escala, o cluster pode consistir em vários peers. Para localizar dados do tenant e melhorar a performance, use sharding customizado para atribuir tenants a shards específicos com base no hash do ID do tenant. Isso localizará as requisições do tenant em nós específicos em vez de transmiti-las para todos os nós, melhorando a performance e reduzindo a carga em cada nó.
Se os Tenants Têm Tamanhos Desiguais
Se alguns tenants são muito maiores que outros, use multitenancy em camadas para promover tenants grandes para shards dedicados, enquanto mantém tenants pequenos em shards compartilhados. Isso otimiza a alocação de recursos e a performance para tenants de tamanhos variados.
Necessidade de Isolamento Estrito de Tenant
Use quando: requisitos legais/de conformidade exigem criptografia por tenant ou isolamento estrito além do que a filtragem por payload oferece.
- Múltiplas coleções podem ser necessárias para chaves de criptografia por tenant
- Limite a contagem de coleções e use filtragem por payload dentro de cada coleção
- Esta é a exceção, não o padrão. Use apenas quando a conformidade exigir.
O Que NÃO Fazer
- Não crie uma coleção por tenant sem justificativa de conformidade (não escala além de centenas)
- Não pule
is_tenant=trueno índice do tenant (prejudica a performance de leitura sequencial) - Não construa HNSW global para coleções multi-tenant (desperdício, use
payload_mem vez disso)
Perguntas frequentes
Devo criar uma coleção separada para cada cliente?
Geralmente não. Criar muitas coleções pode consumir muitos recursos e não funciona bem para mais de algumas centenas de clientes. É melhor usar uma coleção compartilhada com filtros.
O que são 'tenants'?
'Tenants' são seus clientes, usuários ou grupos que usam seu sistema. Cada um tem seus próprios dados que precisam ser separados.
Quando preciso de isolamento estrito entre clientes?
Você precisa de isolamento estrito apenas se houver requisitos legais ou de conformidade que exijam criptografia separada por cliente ou uma separação muito forte dos dados, além do que os filtros normais oferecem.
Detalhes
Descrição original do autor
Guides Qdrant multi-tenant scaling. Use when someone asks 'how to scale tenants', 'one collection per tenant?', 'tenant isolation', 'dedicated shards', or reports tenant performance issues. Also use when multi-tenant workloads outgrow shared infrastructure.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5311
- 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