Tutoriais de agregação

Visão geral

Os tutoriais de aggregation fornecem explicações detalhadas de tarefas comuns de aggregation em um formato passo a passo. Os tutoriais são adaptados de exemplos no livro Practical MongoDB Aggregations por paul feito.

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.

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.

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);

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

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

• Subconjunto filtrado

• Grupo e total

• Descompactar arrays e grupo

• Junção um para um

• Junção de vários campos