Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Referencias de bases de datos: Referencias manuales y DBRefs

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:

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.

Para crear una referencia manual en la interfaz de usuario de MongoDB Atlas, siga estos pasos:

1
  1. 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.

  2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

    La página de clústeres se muestra.

2
  1. Para el clúster en que deseas añadir una referencia de base de datos, haz clic en Browse Collections.

  2. En el panel de navegación izquierdo, seleccione la base de datos.

  3. En el panel de navegación izquierdo, selecciona la colección. Este ejemplo hace referencia a una colección places.

3
  1. Haga clic en Insert Document.

  2. Haz clic en el ícono de vista JSON ({{}}).

  3. Pega los siguientes datos en el documento:

    {
    "_id": {
    "$oid": "651aea5870299b120736f442"
    },
    "name": "Broadway Center",
    "url": "bc.example.net"
    }
  4. Haga clic en Insert.

4
  1. En el panel de navegación izquierdo, selecciona otra colección. Este ejemplo hace referencia a una colección people.

  2. Haga clic en Insert Document.

  3. Haz clic en el ícono de vista JSON ({{}}).

  4. Pega los siguientes datos en el documento:

    {
    "_id": {
    "$oid": "651aebeb70299b120736f443"
    },
    "name": "Erin",
    "places_id": {
    "$oid": "651aea5870299b120736f442"
    },
    "url": "bc.example.net/Erin"
    }
  5. 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ón places para el documento referenciado por el campo places_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.

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.'
}

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.

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.

Los DBRefs tienen los siguientes campos:

$ref

El campo $ref contiene el nombre de la colección en que reside el documento referenciado.

$id

El campo $id contiene el valor del campo _id en el documento referenciado.

$db

Opcional.

Contiene el nombre de la base de datos en que se encuentra el documento referenciado.

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.

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.