Para la mayoría de los casos de uso de MongoDB, el modelo de datos desnormalizado almacena datos relacionados en un solo documento. En algunos casos, es necesario almacenar información relacionada en documentos separados, normalmente en colecciones o bases de datos diferentes.
Importante
Puede usar la etapa de $lookup del pipeline para realizar una unión externa izquierda con una colección no fragmentada en la misma base de datos.
También puedes usar la $graphLookup etapa de la pipeline para unir una colección no fragmentada y realizar búsquedas recursivas.
Esta página describe procedimientos alternativos que preceden a las $lookup y $graphLookup etapas de la pipeline.
Las aplicaciones de MongoDB utilizan uno de dos métodos para relacionar documentos:
Las referencias manuales guardan el campo
_idde un documento en otro como referencia. Su aplicación ejecuta una segunda consulta para obtener los datos relacionados. Las referencias manuales funcionan en la mayoría de los casos y, por lo general, se recomienda usarlas en lugar de DBRefs.
Referencias del manual
Segundo plano
Una referencia manual incluye el campo _id de un documento en otro documento. La aplicación luego puede ejecutar una segunda query para resolver los campos referenciados según sea necesario.
Crea una referencia manual en la Interfaz de Usuario de MongoDB Atlas
Para crear una referencia manual en la interfaz de usuario de MongoDB Atlas, siga estos pasos:
En la interfaz de usuario de MongoDB Atlas, ir a la página Clusters del proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Navega a la colección.
Para el clúster en que deseas añadir una referencia de base de datos, haz clic en Browse Collections.
En el panel de navegación izquierdo, seleccione la base de datos.
En el panel de navegación izquierdo, selecciona la colección. Este ejemplo hace referencia a una colección
places.
Agregar un documento en la colección people que haga referencia a la entrada en places.
En el panel de navegación izquierdo, selecciona otra colección. Este ejemplo hace referencia a una colección
people.Haga clic en Insert Document.
Haz clic en el ícono de vista JSON ({{}}).
Pega los siguientes datos en el documento:
{ "_id": { "$oid": "651aebeb70299b120736f443" }, "name": "Erin", "places_id": { "$oid": "651aea5870299b120736f442" }, "url": "bc.example.net/Erin" } Haga clic en Insert.
Cuando una query devuelve el documento de la colección
people, puedes, si es necesario, filtrar los resultados de la query de la colecciónplacespara el documento referenciado por el campoplaces_id.Para obtener más información sobre cómo ejecutar queries en MongoDB Atlas, consulta Ver, filtrar y ordenar documentos en la documentación de MongoDB Atlas.
Crea una referencia manual en el terminal
Considere la siguiente operación para insertar dos documentos, usando el campo _id del primer documento como referencia en el segundo documento:
const original_id = db.movies.insertOne({ title: "Reference Demo Film 2099" }).insertedId db.comments.insertOne({ name: "Reference Demo Viewer", movie_id: original_id, text: "A thrilling adventure set in the future." })
Para recuperar el documento al que hace referencia el campo movie_id, realice una segunda consulta para el documento en la colección movies:
db.comments.findOne( { movie_id: original_id }, { name: 1, text: 1, _id: 0 } )
{ name: 'Reference Demo Viewer', text: 'A thrilling adventure set in the future.' }
Usar
Para casi todos los casos en los que desee almacenar una relación entre dos documentos, utilice referencias manuales. Son fáciles de crear y su aplicación puede resolverlas según sea necesario.
DBRefs
Segundo plano
Los DBRefs son una convención para representar un documento, en lugar de un tipo de referencia específico. Incluyen el nombre de la colección y, en algunos casos, el nombre de la base de datos, además del valor del campo _id.
Opcionalmente, las DBRefs pueden incluir cualquier número de otros campos. Los nombres de campos extra deben seguir las reglas para los nombres de campos impuestas por la versión del servidor.
Para resolver DBRefs, la aplicación debe realizar consultas adicionales para devolver los documentos referenciados. Algunos controladores de MongoDB proporcionan métodos auxiliares que resuelven los DBRef en documentos, pero la resolución no es automática.
Formato
Los DBRefs tienen los siguientes campos:
$refEl campo
$refcontiene el nombre de la colección en que reside el documento referenciado.
$idEl campo
$idcontiene el valor del campo_iden el documento referenciado.
$dbOpcional.
Contiene el nombre de la base de datos en que se encuentra el documento referenciado.
Ejemplo
Los documentos DBRef se asemejan al siguiente documento:
{ "$ref" : <value>, "$id" : <value>, "$db" : <value> }
Considere un documento de una colección que almacenó un DBRef en un campo creator:
{ "_id" : ObjectId("5126bbf64aed4daf9e2ab771"), // .. application fields "creator" : { "$ref" : "creators", "$id" : ObjectId("5126bc054aed4daf9e2ab772"), "$db" : "users", "extraField" : "anything" } }
El DBRef en este ejemplo apunta a un documento en la colección creators de la base de datos users que tiene ObjectId("5126bc054aed4daf9e2ab772") en su campo _id. También contiene un campo opcional.
Nota
El orden de los campos en el DBRef es importante, y debe usar la secuencia anterior al utilizar un DBRef.
Soporte de controladores para DBRefs
Controlador | Soporte para DBRef | notas |
|---|---|---|
C | No es compatible | Puedes recorrer las referencias manualmente. |
C++ | No es compatible | Puedes recorrer las referencias manualmente. |
C# | Admitido | Consulta la página del driver .NET/C# para más información. |
Go | No es compatible | Puedes recorrer las referencias manualmente. |
Haskell | No es compatible | Puedes recorrer las referencias manualmente. |
Java | Admitido | Consulta la página del controlador Java para obtener más información. |
Node.js | Admitido | Consulta la página del controlador Node.js para obteners más información. |
Perl | Admitido | Véase la página del controlador Perl para obtener más información. |
PHP | No es compatible | Puedes recorrer las referencias manualmente. |
Python | Admitido | Consulta la página del driver PyMongo para obtener más información. |
Ruby | Admitido | Consulta la página del controlador de Ruby para obtener más información. |
Scala | No es compatible | Puedes recorrer las referencias manualmente. |