Compartilhar via


Inserir dados no Azure Cosmos DB para MongoDB

Uma das operações mais básicas é inserir dados em uma coleção. Neste guia, abordaremos tudo o que você precisa saber sobre como inserir dados usando o Mongo Shell (Mongosh).

Inserir um único documento

A maneira mais básica de inserir dados no MongoDB é inserir um único documento. Para fazer isso, você pode usar o método db.collection.insertOne(). O método insertOne() usa um único documento como argumento e o insere na coleção especificada. Veja um exemplo de como você pode usar este método:

db.myCollection.insertOne({
  name: "John Smith",
  age: 30,
  address: "123 Main St"
});

Neste exemplo, estamos inserindo um documento na coleção "myCollection" com os seguintes campos: "name", "age" e "address". Depois que o comando for executado, você verá o reconhecimento: true e insertedId: ObjectId("5f5d5f5f5f5f5f5f5f5f5f5f5f5f") na saída, em que insertedId é o identificador exclusivo gerado pelo MongoDB para o documento inserido.

Inserir vários documentos

Em muitos casos, você precisará inserir vários documentos ao mesmo tempo. Para fazer isso, você pode usar o método db.collection.insertMany(). O método insertMany() usa uma matriz de documentos como argumento e os insere na coleção especificada. Aqui está um exemplo:

db.myCollection.insertMany([
  {name: "Jane Doe", age: 25, address: "456 Park Ave"},
  {name: "Bob Smith", age: 35, address: "789 Elm St"},
  {name: "Sally Johnson", age: 40, address: "111 Oak St"}
]);

Neste exemplo, inserimos três documentos na coleção "myCollection". Cada documento tem os mesmos campos do exemplo anterior: "name", "age" e "address". O método insertMany() retorna uma confirmação: true e insertedIds: [ObjectId("5f5d5f5f5f5f5f5f5f5f5f5f"), ObjectId("5f5d5f5f5f5f5f5f5f5f5f5f"), ObjectId("5f5d5f5f5f5f5f5f5f5f5f5f")] em que insertedIds é uma matriz de identificadores exclusivos gerados pelo MongoDB para cada documento inserido.

Inserir com opções

insertOne() e insertMany() aceitam um segundo argumento opcional, que pode ser usado para especificar opções para a operação de inserção. Por exemplo, para definir a opção "ordenada" como false, você pode usar o seguinte código:

db.myCollection.insertMany([
  {name: "Jane Doe", age: 25, address: "456 Park Ave"},
  {name: "Bob Smith", age: 35, address: "789 Elm St"},
  {name: "Sally Johnson", age: 40, address: "111 Oak St"}
], {ordered: false});

Isso instrui o MongoDB a inserir os documentos de maneira não ordenada, o que significa que, se um documento não for inserido, ele continuará com o próximo. Isso é recomendado para o desempenho de gravação no Cosmos DB para MongoDB

Próximas etapas