Insertar documentos

Overview

En esta guía, puedes aprender cómo usar el controlador de Ruby para agregar documentos a una colección MongoDB mediante la realización de operaciones de inserción.

Una operación de inserción inserta uno o más documentos en una colección de MongoDB. Puedes realizar una operación de inserción mediante los siguientes métodos:

• insert_one para insertar un solo documento

• insert_many para insertar uno o más documentos

database = client.use('sample_restaurants')
collection = database[:restaurants]

El campo _id

En una colección de MongoDB, cada documento debe contener un campo _id con un valor de campo único.

MongoDB permite gestionar este campo de dos formas:

• Establece el campo _id para cada documento tú mismo, asegurándote de que cada valor sea único.

• Permite que el driver genere automáticamente valores únicos de BSON::ObjectId para cada campo _id del documento.

A menos que pueda garantizar la exclusividad, recomendamos dejar que el controlador genere automáticamente los valores de _id.

Para obtener más información sobre el campo _id, consulta la guía Índices únicos en el manual del MongoDB Server.

Para obtener más información sobre la estructura y las reglas de los documentos, consulta la guía de Documentos en el manual de MongoDB Server.

Inserta un documento

Para añadir un solo documento a una colección de MongoDB, llama al método insert_one y pasa el documento que quieres insertar.

El siguiente ejemplo inserta un documento en la colección restaurants:

document = { name: 'Neighborhood Bar & Grill', borough: 'Queens' }
collection.insert_one(document)

Inserta varios documentos

Para añadir varios documentos a una colección de MongoDB, llama al método insert_many y pasa una lista de documentos que deseas insertar.

El siguiente ejemplo inserta dos documentos en la colección restaurants:

documents = [
  { name: 'Metropolitan Cafe', borough: 'Queens' },
  { name: 'Yankee Bistro', borough: 'Bronx' }
]
collection.insert_many(documents)

Modificar el comportamiento de inserción

Puede pasar un objeto Hash como parámetro al método insert_one para configurar las opciones de inserción. Si no especifica ninguna opción, el controlador ejecuta la inserción con la configuración predeterminada.

La siguiente tabla describe las opciones que puede configurar para la insert_one operación:

Puedes configurar los ajustes anteriores en el método insert_many pasando un Hash como parámetro en la llamada al método. También puedes utilizar la opción ordered para especificar el orden en el que el driver inserta documentos en MongoDB.

documents = [
  { name: 'Cloudy Day', borough: 'Brooklyn' },
  { name: 'Squall or Shine', borough: 'Staten Island' }
  { name: 'Rose Field', borough: 'Queens' }
]
options = { bypass_document_validation: true }
collection.insert_many(documents, options)

Documentación de la API

Para obtener más información sobre cualquiera de los métodos mencionados en esta guía, consulta la siguiente documentación de la API:

• insert_one

• insert_many