$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.

CategoriaAcumuladores
Versão do MongoDB3.2+
Idioma do Exemplomongosh (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

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.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%