$accumulator (Acumulador Personalizado)

Última atualização: 2026-10-09

$accumulator (Acumulador Personalizado)

$accumulator define lógica de acumulador personalizada com callbacks JavaScript — init, accumulate, merge, finalize — dentro de $group. Ele cobre lógica de agregação que os acumuladores nativos não conseguem expressar. Ele executa JavaScript no lado do servidor e é mais lento que os acumuladores nativos.

📝 Sintaxe

{ $accumulator: { init: <function>, accumulate: <function>, accumulateArgs: [ <expression> ], merge: <function>, finalize: <function>, lang: "js" } }

Retorno：Resultado de acumulação personalizado (tipo definido pelas suas funções)

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $accumulator: conta preços distintos por item com um Set
db.sales.aggregate([
  { $group: { _id: '$item', uniq: {
    $accumulator: {
      init: function() { return new Set(); },
      accumulate: function(set, v) { set.add(v); },
      accumulateArgs: ['$price'],
      merge: function(a, b) { for (var v of b) a.add(v); },
      finalize: function(set) { return set.size; },
      lang: 'js'
    }
  } }
])

Saída：

// Contagem de preços distintos por item

📌 Notas

• Executa JavaScript no lado do servidor, mais lento que acumuladores nativos
• Os callbacks precisam ser serializáveis e não podem capturar variáveis externas
• O callback merge combina resultados de grupos em configurações fragmentadas ou distribuídas

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

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.

Sobre Nós