$sqrt (Raiz Quadrada)
Última atualização: 2026-10-09
$sqrt (Raiz Quadrada)
$sqrt retorna a raiz quadrada de uma única expressão numérica. É usado em geometria, cálculos do tipo desvio padrão e normalização, como tirar a raiz quadrada de uma soma de quadrados ao calcular distância euclidiana. Um argumento null ou ausente resulta em null, e entrada negativa também retorna null, pois números negativos não têm raiz quadrada real. $sqrt é equivalente a $pow: [x, 0.5], mas fica mais claro. Ele suporta inteiros, doubles e Decimals.
| Categoria | Matemática |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $sqrt: <expressão numérica> }⚙️ Parâmetros
| valor numérico | Um valor numérico ou uma expressão que resolva para um; deve ser não negativo. |
|---|
Retorno：A raiz quadrada da entrada; null para entrada negativa, null ou ausente
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $sqrt: distância a partir dos dois catetos de um triângulo retângulo
db.points.aggregate([
{ $project: {
distance: { $sqrt: { $add: [{ $pow: ['$x', 2] }, { $pow: ['$y', 2] }] } }
} }
])Saída：
{ '_id': 1, 'distance': 5 }
{ '_id': 2, 'distance': 10 }📌 Notas
- Entrada negativa retorna null em vez de gerar erro
- Equivalente a $pow: [x, 0.5], mas com intenção mais clara
- Argumentos null ou ausentes resultam em null
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO que $sqrt retorna para entrada negativa?
AEle retorna null; números negativos não têm raiz quadrada real.
QComo $sqrt e $pow se relacionam?
A$sqrt(x) é igual a $pow: [x, 0.5].
QO $sqrt suporta Decimal?
ASim, uma entrada Decimal retorna um resultado Decimal.
