Menu Docs
Página inicial do Docs
/
Idiomas
/
JavaScript
/
Node.js

Tutoriais de agregação

Nesta página

  • Visão geral
  • Aplicativo de modelo de agregação
  • Tutoriais disponíveis

Visão geral

Os tutoriais de agregação fornecem explicações detalhadas de tarefas comuns de agregação em um formato passo a passo. Os tutoriais são adaptados de exemplos no livro Practical MongoDB Aggregations de Paul Done.

Cada tutorial inclui as seguintes seções:

  • Introdução, que descreve a finalidade e os casos de uso comuns do tipo de agregação. Essa seção também descreve o exemplo e o resultado desejado que o tutorial demonstra.

  • Antes de começar, que descreve os banco de dados, as coleções e os dados de amostra necessários que você deve ter antes de criar o pipeline de agregação e realizar a agregação.

  • Tutorial, que descreve como criar e executar o pipeline de agregação. Esta seção descreve cada estágio do tutorial de agregação completo e, em seguida, explica como executar e interpretar a saída da agregação.

No final de cada tutorial de agregação, haverá um link para um arquivo de código Node.js totalmente executável que você pode executar em seu ambiente.

Dica

Para saber mais sobre como realizar agregações, consulte o guia deagregação .

Aplicativo de modelo de agregação

Antes de começar a seguir um tutorial de agregação, você deve configurar um novo aplicativo Node.js. Você pode usar esse aplicativo para se conectar a uma implantação do MongoDB, inserir dados de exemplo no MongoDB e executar o pipeline de agregação em cada tutorial.

Dica

Para saber como instalar o driver e se conectar ao MongoDB, consulte a etapa Baixar e instalar, bem como a etapa Criar uma implementação do MongoDB no guia Início rápido.

Após instalar o driver, crie um arquivo chamado agg_tutorial.js. Cole o seguinte código neste arquivo para criar um modelo de aplicativo para os tutoriais de agregação:

const { MongoClient } = require("mongodb");
// Replace the placeholder with your connection string.
const uri = "<connection string>";
const client = new MongoClient(uri);
async function run() {
  try {
    const aggDB = client.db("agg_tutorials_db");
    // Get a reference to relevant collections.
    // ... const someColl =
    // ... const anotherColl =
    // Delete any existing documents in collections.
    // ... await someColl.deleteMany({});
    // Insert sample data into the collection or collections.
    // ... const someData = [ ... ];
    // ... await someColl.insertMany(someData);
    // Create an empty pipeline array.
    const pipeline = [];
    // Add code to create pipeline stages.
    // ... pipeline.push({ ... })
    // Run the aggregation.
    // ... const aggregationResult = ...
    // Print the aggregation results.
    for await (const document of aggregationResult) {
      console.log(document);
    }
  } finally {
    await client.close();
  }
}
run().catch(console.dir);

Importante

No código anterior, leia os comentários de código para localizar as seções do código que você deve modificar para o tutorial que você está seguindo.

Se você tentar executar o código sem fazer alterações, encontrará um erro de conexão.

Para cada tutorial, você deve substituir o placeholder da string de conexão pela string de conexão da sua implantação.

Dica

Para saber como localizar a string de conexão da sua implantação, consulte a etapa Criar uma string de conexão do guia de início rápido.

Por exemplo, se sua string de conexão for "mongodb+srv://mongodb-example:27017", sua atribuição de string de conexão será semelhante à seguinte:

const uri = "mongodb+srv://mongodb-example:27017";

Para executar o arquivo completo após modificar o modelo de um tutorial, execute o seguinte comando em seu shell:

node agg_tutorial.js

Tutoriais disponíveis

Voltar

Criptografia em execução