Overview
En esta guía, podrá aprender sobre la Mongoid::Document módulo en Mongoid. El módulo Document es una implementación en Ruby de un documento MongoDB, que almacena datos en pares de campo y valor. Para aprender más sobre la terminología, estructura y limitaciones de los documentos de MongoDB, consulta Documentos en el manual del servidor.
Debes incluir el módulo Mongoid::Document en cualquier clase que desees persistir en MongoDB. Incluyendo el módulo Document en tu clase de modelo, puedes utilizar sus métodos en instancias de tu clase de modelo.
El siguiente código demuestra cómo incluir el módulo Document en una clase modelo Person de muestra:
class Person include Mongoid::Document field :name, type: String end
Puedes encontrar más información sobre el módulo Document en la documentación de la API.
Trabajar con documentos
Puedes almacenar instancias de tus modelos directamente en una colección, o puedes incrustarlas en otras clases que utilicen el módulo Document. Cuando se guarda una instancia de Document en MongoDB, se convierte en un objeto BSON que es similar a un hash de Ruby o un objeto JSON.
El siguiente código crea una instancia del modelo Person definido en la sección anterior:
Person.create(name: 'Meena Kumar')
El documento aparece en MongoDB de la siguiente manera:
{ "_id": { "$oid": "673b6dce61700598c24a72b0" }, "name": "Meena Kumar" }
Nota
Campo _id
Cuando se persiste una instancia de un modelo en la base de datos, MongoDB agrega automáticamente un campo _id que tiene un valor único, incluso si no se define explícitamente este campo en el modelo.
Para obtener más información sobre este campo, consulta la referencia ObjectId en el manual del servidor.
Información Adicional
Para obtener más información sobre los tipos de campos que puede utilizar en los modelos de Mongoid, consulte el Utilice laguía de tipos de campos BSON.
Para aprender a acceder y modificar tus datos en MongoDB, consulta las guías de Interacción con Datos.
Para obtener más información sobre cómo modelar tus datos con modelos Mongoid, consulta las guías Modela tus datos.