MongoDB Matriz de objetos usando insert() com exemplo

O que é o método insert() em MongoDB?

O método insert() em MongoDB Adiciona um ou mais documentos a uma coleção. Um documento é um conjunto de pares campo-valor armazenados em BSON, uma forma binária de JSON. Quando você passa um único documento, `insert()` armazena esse registro; quando você passa um array de documentos, ele os armazena todos em uma única operação, o que é mais rápido do que inseri-los um por um.

O método é executado em uma coleção específica usando o padrão db.collection.insert(). Se a coleção de destino ainda não existir, MongoDB Ele é criado automaticamente durante a primeira inserção. Cada documento também recebe um campo _id exclusivo, caso você não forneça um, para que cada registro possa ser identificado posteriormente.

Embora insert() ainda funcione, versões mais recentes MongoDB As versões oferecem os métodos `insertOne()` e `insertMany()` como substitutos mais claros. Os exemplos abaixo usam `insert()` para adicionar uma matriz de documentos de funcionários e, em seguida, exibem os resultados em um formato JSON legível.

Adicionando uma matriz de documentos

O comando “inserir” também pode ser usado para inserir vários documentos em uma coleção ao mesmo tempo. O exemplo de código abaixo pode ser usado para inserir vários documentos de uma vez.

O exemplo a seguir mostra como isso pode ser feito,

Passo 1) Crie uma JavaScript variável chamada myEmployee para armazenar a matriz de documentos

Passo 2) Adicione os documentos necessários com o nome do campo e valores à variável

Passo 3) Use o comando insert para inserir a matriz de documentos na coleção

var myEmployee=
	[
		{
			"Employeeid" : 1,
			"EmployeeName" : "Smith"
		},
		{
			"Employeeid"   : 2,
			"EmployeeName" : "Mohan"
		},
		{
			"Employeeid"   : 3,
			"EmployeeName" : "Joe"
		},
	];

	db.Employee.insert(myEmployee);

Se o comando for executado com sucesso, a seguinte saída será mostrada

A saída mostra que esses 3 documentos foram adicionados à coleção.

Como inserir uma matriz dentro de um documento

Além de inserir uma série de documentos separados, MongoDB Permite armazenar um array como um campo dentro de um único documento. Isso é útil quando um registro contém naturalmente uma lista de valores, como um funcionário com várias habilidades ou um aluno matriculado em vários cursos. MongoDB Utiliza um modelo de documento flexível, onde o array reside diretamente dentro do objeto, em vez de em uma tabela separada, o que mantém os dados relacionados juntos.

O exemplo a seguir insere um documento de funcionário que contém um campo de matriz chamado Habilidades:

db.Employee.insert(
   {
      "Employeeid" : 4,
      "EmployeeName" : "Alan",
      "Skills" : [ "MongoDB", "Node.js", "Express" ]
   }
);

As partes deste documento funcionam da seguinte maneira:

• ID do funcionário e Nome do empregado são pares comuns de campo e valor.
• Competências É um campo de matriz que armazena três valores de string entre colchetes.
• Todo o documento, incluindo a matriz incorporada, é armazenado em uma única operação de inserção.

Após adicionar o registro, você pode confirmar a matriz incorporada com uma consulta de busca que imprime o resultado em JSON:

db.Employee.find( { "Employeeid" : 4 } ).forEach(printjson)

O resultado mostra a matriz Skills aninhada dentro do documento do funcionário. LaterVocê pode adicionar novos valores à matriz com o operador `$push` ou ler um único elemento pela sua posição de índice. Armazenar valores conectados dessa forma mantém cada documento independente, reduz a necessidade de junções entre coleções e torna os dados mais fáceis de ler e manter.

insert() vs insertOne() vs insertMany()

MongoDB Oferece três métodos relacionados para adicionar dados. A tabela abaixo os compara para que você possa escolher o mais adequado:

Para novos projetos, use insertOne() e insertMany(), pois eles fornecem uma intenção mais clara e relatórios de erros mais precisos. O método insert() permanece disponível principalmente para manter a compatibilidade com versões anteriores de tutoriais e scripts.

Imprimindo no formato JSON

JSON é um formato chamado JavaNotação de objeto de script, e é apenas uma forma de armazenar informações de maneira organizada e fácil de ler. Em nossos exemplos adicionais, usaremos a funcionalidade de impressão JSON para ver a saída em um formato melhor.

Vejamos um exemplo de impressão no formato JSON

db.Employee.find().forEach(printjson)

Code Explicação:

1. A primeira alteração consiste em adicionar a função `forEach()` à função `find()`. Isso garante que cada documento da coleção seja percorrido explicitamente. Dessa forma, você tem mais controle sobre o que pode fazer com cada um dos documentos da coleção.
2. A segunda mudança é colocar o comando printjson na instrução forEach. Isso fará com que cada documento da coleção seja exibido no formato JSON.

Se o comando for executado com sucesso, a seguinte saída será mostrada

Saída:

A saída mostra claramente que todos os documentos são impressos no estilo JSON.

Perguntas Frequentes