Menu Docs

Insira um documento

Você pode inserir um único documento em uma coleção usando o método insertOne() em um objeto MongoCollection. Para inserir um documento, crie um objeto Document que contenha os campos e valores que você deseja armazenar. Se você chamar o método insertOne() em uma coleção que ainda não existe, o servidor criará automaticamente para você.

Após uma inserção bem-sucedida, o insertOne() retorna uma instância de InsertOneResult. Você pode recuperar informações como o campo _id do documento inserido chamando o método getInsertedId() na instância InsertOneResult.

Se a sua operação de inserção falhar, o driver emitirá uma exceção. Para obter mais informações sobre os tipos de exceções geradas em condições específicas, consulte a documentação da API para insertOne(), cujo link está no final desta página.

O trecho a seguir insere um único documento na coleção movies.

Observação

Esse exemplo se conecta a uma instância do MongoDB usando um URI de conexão. Para saber mais sobre como se conectar à sua instância do MongoDB , consulte oguia de conexão .

// Inserts a sample document describing a movie by using the Java driver
package usage.examples;
import java.util.Arrays;
import org.bson.Document;
import org.bson.types.ObjectId;
import com.mongodb.MongoException;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.result.InsertOneResult;
public class InsertOne {
public static void main(String[] args) {
// Replace the uri string with your MongoDB deployment's connection string
String uri = "<connection string uri>";
try (MongoClient mongoClient = MongoClients.create(uri)) {
MongoDatabase database = mongoClient.getDatabase("sample_mflix");
MongoCollection<Document> collection = database.getCollection("movies");
try {
// Inserts a sample document describing a movie into the collection
InsertOneResult result = collection.insertOne(new Document()
.append("_id", new ObjectId())
.append("title", "Ski Bloopers")
.append("genres", Arrays.asList("Documentary", "Comedy")));
// Prints the ID of the inserted document
System.out.println("Success! Inserted document id: " + result.getInsertedId());
// Prints a message if any exceptions occur during the operation
} catch (MongoException me) {
System.err.println("Unable to insert due to an error: " + me);
}
}
}
}

Ao executar o exemplo, você deverá visualizar o resultado com o ObjectId do documento inserido no campo de valor que se assemelha ao seguinte:

Inserted document id: BsonObjectId{value=...}

Dica

Legacy API

Se você estiver usando a API herdada, consulte nossa página de perguntas frequentes para saber quais alterações devem ser feitas nesse exemplo de código.

Para obter mais informações sobre as classes e métodos mencionados nesta página, consulte a seguinte documentação da API: