Referências de banco de dados

Plano de fundo

Uma referência manual é a prática de incluir o campo _id de um documento em outro documento. O aplicativo pode então emitir uma segunda query para resolver os campos referenciados conforme necessário.

Crie uma referência manual na UI do MongoDB Atlas

Para criar uma referência manual na interface do usuário do MongoDB Atlas, siga estas etapas:

Criar uma Referência Manual no Terminal

Considere a seguinte operação para inserir dois documentos, usando o campo _id do primeiro documento como referência no segundo documento:

original_id = ObjectId()
db.places.insertOne({
    "_id": original_id,
    "name": "Broadway Center",
    "url": "bc.example.net"
})
db.people.insertOne({
    "name": "Erin",
    "places_id": original_id,
    "url":  "bc.example.net/Erin"
})

Em seguida, quando uma query retorna o documento da coleção people, você pode, se necessário, fazer uma segunda query para o documento referenciado pelo campo places_id na coleção places.

Usar

Para quase todos os casos em que você deseja armazenar uma relação entre dois documentos, use referências manuais. As referências são simples de criar e seu aplicativo pode resolver as referências conforme necessário.

A única limitação da vinculação manual é que essas referências não transmitem os nomes do banco de dados e da collection. Se você tiver documentos em uma única collection relacionados a documentos em mais de uma collection, talvez seja necessário considerar o uso de DBRefs.

Plano de fundo

DBRefs são uma convenção para representar um documento, em vez de um tipo de referência específico. Elas incluem o nome da coleção e, em alguns casos, o nome do banco de dados, além do valor do campo _id.

Opcionalmente, os DBRefs podem incluir qualquer número de outros campos. Os nomes de campo extras devem seguir todas as regras para nomes de campo impostas pela versão do servidor.

Formatar

Os DBRefs têm os seguintes campos:

$ref

O campo $ref detém o nome da coleção onde reside o documento referenciado.

$id

O campo $id contém o valor do campo _id no documento referenciado.

$db

Opcional.

Contém o nome do banco de dados onde reside o documento referenciado.

{ "$ref" : <value>, "$id" : <value>, "$db" : <value> }

{
  "_id" : ObjectId("5126bbf64aed4daf9e2ab771"),
  // .. application fields
  "creator" : {
                  "$ref" : "creators",
                  "$id" : ObjectId("5126bc054aed4daf9e2ab772"),
                  "$db" : "users",
                  "extraField" : "anything"
               }
}

Suporte ao driver para DBRefs

Usar

Na maioria dos casos, você deve usar o método de referência manual para conectar dois ou mais documentos relacionados. No entanto, se você precisar referenciar documentos de várias coleções, considere usar DBRefs.