$stdDevSamp (Acumulador de Desvio Padrão Amostral)
Última atualização: 2026-10-09
$stdDevSamp (Acumulador de Desvio Padrão Amostral)
$stdDevSamp é um acumulador que calcula o desvio padrão amostral de um campo em um grupo, dividindo por N-1. Use-o quando os dados forem uma amostra de uma população maior — o caso comum. Valores não numéricos são ignorados; o denominador difere de $stdDevPop.
| Categoria | Acumuladores |
|---|---|
| Versão do MongoDB | 3.2+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $group: { _id: <key>, dev: { $stdDevSamp: "$field" } } }
Retorno:Desvio padrão amostral (valores não numéricos ignorados)
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $stdDevSamp: desvio padrão amostral das notas por turma
db.scores.aggregate([
{ $group: { _id: '$class', dev: { $stdDevSamp: '$score' } } }
])
Saída:
{ "_id": "A", "dev": 13.02 }
📌 Notas
- O desvio padrão amostral divide por N-1
- Valores null e não numéricos são ignorados
- Precisa de ao menos dois valores numéricos por grupo, senão null
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQuando devo usar o desvio padrão amostral?
AQuando os dados são uma amostra da população, por exemplo comportamentos de usuários coletados de forma aleatória.
Q$stdDevSamp funciona com dois documentos?
ASão necessários ao menos dois valores numéricos por grupo; caso contrário, null.
Q$stdDevSamp e $stdDevPop concordam?
AFicam próximos para conjuntos grandes, mas diferem visivelmente para amostras pequenas.