Criar Coleção MongoDB

Introdução

Neste laboratório, você aprenderá os passos fundamentais para trabalhar com o MongoDB. Você usará o MongoDB Shell (mongosh) para criar um banco de dados, adicionar uma coleção, inserir documentos e realizar operações básicas de gerenciamento de dados. Essa abordagem prática fornecerá experiência prática em comandos essenciais do MongoDB, estabelecendo uma base sólida para tarefas de banco de dados mais avançadas.

Iniciar Shell MongoDB e Criar um Banco de Dados

Seu primeiro passo é conectar-se ao servidor MongoDB usando seu shell interativo, mongosh. Esta ferramenta permite que você execute comandos diretamente contra sua instância de banco de dados.

No seu terminal, inicie o MongoDB Shell executando o comando mongosh.

mongosh

Você verá uma mensagem de conexão, indicando que você está agora no ambiente mongosh.

Current Mongosh Log ID: 65a7f3e8f5a8a9b3c4d5e6f7
Connecting to:           mongodb://127.0.0.1:27017/
Using MongoDB:           8.0.2
Using Mongosh:           2.2.6
...
test>

O prompt test> indica que você está atualmente conectado ao banco de dados padrão test. Vamos mudar para um novo banco de dados para o nosso projeto. No MongoDB, você pode mudar para um banco de dados que ainda não existe. Ele será criado automaticamente quando você armazenar dados nele pela primeira vez.

Use o comando use para mudar para um novo banco de dados chamado my_store.

use my_store

O shell confirmará a mudança.

switched to db my_store

Para confirmar qual banco de dados você está usando atualmente, você pode digitar db.

db;

A saída mostrará o nome do banco de dados atual.

my_store

Criar uma Coleção e Inserir um Documento

Agora que você está no banco de dados my_store, o próximo passo é criar uma coleção. Uma coleção é um grupo de documentos MongoDB, semelhante a uma tabela em um banco de dados relacional.

Vamos criar uma coleção chamada products. Você pode fazer isso explicitamente com o método createCollection().

db.createCollection("products");

Uma operação bem-sucedida retornará um objeto indicando sucesso.

{ ok: 1 }

Você pode listar todas as coleções no banco de dados atual para verificar se products foi criada.

show collections

products

Com a coleção criada, você agora pode inserir seu primeiro documento. Um documento é um objeto BSON, que é uma serialização codificada em binário de documentos semelhantes a JSON.

Use o método insertOne() para adicionar um único documento à coleção products.

db.products.insertOne({
  name: "Laptop",
  price: 1200,
  category: "Electronics"
});

O MongoDB confirmará a inserção e fornecerá o _id único do novo documento.

{
  acknowledged: true,
  insertedId: ObjectId("...")
}

Este ObjectId é gerado automaticamente para cada documento e serve como sua chave primária.

Inserir Múltiplos Documentos

Frequentemente, você precisará adicionar vários documentos a uma coleção de uma vez. O MongoDB fornece o método insertMany() para este propósito. Este método é mais eficiente do que chamar insertOne() várias vezes.

Vamos adicionar mais dois produtos à nossa coleção products. O método insertMany() recebe um array de objetos de documento como seu argumento.

db.products.insertMany([
  {
    name: "Keyboard",
    price: 75,
    category: "Electronics"
  },
  {
    name: "Desk Chair",
    price: 150,
    category: "Furniture"
  }
]);

A saída confirmará que a operação foi reconhecida e listará os valores de _id para cada um dos documentos recém-inseridos.

{
  acknowledged: true,
  insertedIds: {
    '0': ObjectId("..."),
    '1': ObjectId("...")
  }
}

Agora, vamos verificar o número total de documentos na coleção products. Você pode usar o método countDocuments() para isso.

db.products.countDocuments();

O shell deve retornar 3, refletindo o documento do passo anterior e os dois que você acabou de adicionar.

3

Consultar e Visualizar Documentos

Após inserir dados, você desejará recuperá-los e visualizá-los. O método principal para consultar uma coleção é find().

Para visualizar todos os documentos na coleção products, execute o método find() sem nenhum argumento.

db.products.find();

O shell mongosh formata automaticamente a saída para facilitar a leitura, exibindo todos os três documentos em sua coleção.

[
  {
    _id: ObjectId("..."),
    name: 'Laptop',
    price: 1200,
    category: 'Electronics'
  },
  {
    _id: ObjectId("..."),
    name: 'Keyboard',
    price: 75,
    category: 'Electronics'
  },
  {
    _id: ObjectId("..."),
    name: 'Desk Chair',
    price: 150,
    category: 'Furniture'
  }
]

O método find() também pode aceitar um documento de consulta para filtrar os resultados. Isso permite que você encontre documentos que correspondam a critérios específicos. Por exemplo, vamos encontrar todos os produtos na categoria "Electronics".

db.products.find({ category: "Electronics" });

Este comando retornará apenas os documentos onde o campo category tem o valor "Electronics".

[
  {
    _id: ObjectId("..."),
    name: 'Laptop',
    price: 1200,
    category: 'Electronics'
  },
  {
    _id: ObjectId("..."),
    name: 'Keyboard',
    price: 75,
    category: 'Electronics'
  }
]

Esta capacidade simples de filtragem é um recurso poderoso para recuperar dados específicos de suas coleções.

Excluir uma Coleção

Na etapa final, você aprenderá como remover uma coleção de um banco de dados. Esta operação é irreversível e exclui a coleção, todos os seus documentos e índices. É útil para limpar dados temporários ou remover coleções obsoletas.

Para demonstrar isso, vamos primeiro criar uma coleção temporária.

db.createCollection("temp_data");

{ ok: 1 }

Agora, use o método drop() na coleção temp_data para removê-la.

db.temp_data.drop();

O comando retornará true se a coleção foi removida com sucesso.

true

Para verificar se a coleção foi removida, você pode listar todas as coleções no banco de dados novamente.

show collections

A saída agora mostrará apenas a coleção products, confirmando que temp_data foi excluída.

products

Isso conclui as operações básicas para gerenciar coleções no MongoDB. Lembre-se de sair do shell mongosh quando terminar.

exit;

Resumo

Neste laboratório, você aprendeu as habilidades fundamentais para trabalhar com o MongoDB. Você começou conectando-se a uma instância do MongoDB usando o shell mongosh. Em seguida, praticou a criação de um banco de dados e uma coleção, a inserção de documentos únicos e múltiplos, e a consulta desses dados usando o método find(). Finalmente, você aprendeu como remover com segurança uma coleção usando o comando drop(). Estas operações principais — Criar, Ler e Excluir (Create, Read, Delete) — são os blocos de construção para qualquer aplicação que utiliza o MongoDB como seu armazenamento de dados. Agora você está equipado com o conhecimento básico para gerenciar dados em um ambiente MongoDB.