/ /

Insertar documentos

Overview

En esta guía, puede aprender a utilizar el controlador Ruby para agregar documentos a una colección MongoDB realizando 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

Datos de muestra

Los ejemplos de esta guía utilizan la colección restaurants en la base de datos sample_restaurants de la Conjuntos de datos de muestra de Atlas. Para acceder a esta colección desde su aplicación Ruby, cree un Mongo::Client objeto que se conecte a un clúster de Atlas y asigne los siguientes valores a las variables database collection y:

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

Para aprender cómo crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulte la guía de introducción a MongoDB.

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:

Configure usted mismo el campo _id para cada documento, asegurándose de que cada valor sea único.
Deje que el controlador genere automáticamente valores BSON::ObjectId únicos para cada campo _id del documento.

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

Nota

Los valores duplicados _id violan las restricciones de índice único, lo que hace que el controlador devuelva un error.

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

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

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 agregar varios documentos a una colección MongoDB, llame al método insert_many y pase una lista de documentos que desea 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 configurar la operación insert_one:

Opción	Descripción
`bypass_document_validation`	Instructs the driver whether to ignore document-level validation. For more information, see Schema Validation in the MongoDB Server manual. Defaults to `false`.
`comment`	Sets a comment to attach to the operation. For more information, see the insert command fields guide in the MongoDB Server manual.
`session`	Sets the session to use for the operation. To learn more about sessions, see Client Sessions and Causal Consistency Guarantees in the MongoDB Server manual.
`write_concern`	Sets the write concern for the operation. For more information, see the Write Concern guide in the MongoDB Server manual.

Puede configurar los ajustes anteriores en el método insert_many pasando un parámetro Hash a la llamada del método. También puede usar la opción ordered para especificar el orden en que el controlador inserta los documentos en MongoDB.

Ejemplo

El siguiente código utiliza el método insert_many para insertar tres documentos nuevos en una colección. Dado que la opción bypass_document_validation está habilitada, esta operación de inserción omite la validación a nivel de documento.

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 analizados en esta guía, consulte la siguiente documentación de API:

Volver

Ejecute un comando de base de datos

Documentos de query