手动引用将一个文档的 _id字段保存在另一个文档中作为引用。应用程序运行第二个查询以返回相关数据。手动引用适用于大多数使用案例，通常应优先于 DBRef。
DBRef 是指使用第一个文档的 _id字段的值、集合名称、数据库名称（可选）以及任何其他字段从一个文档到另一个文档的引用。除非您的应用程序明确需要使用 DBRef，否则请改用手动引用。

手动引用

背景

手动引用在另一个文档中包含一个文档的 _id字段。然后，应用程序可以根据需要运行第二个查询来解析引用的字段。

在 MongoDB Atlas 用户界面中创建手动引用

要在 MongoDB Atlas UI 中创建手动引用，请完成以下步骤：

在 MongoDB Atlas 用户界面中，转到您项目的 Clusters（集群）页面。

如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中，单击 Database 标题下的 Clusters。
会显示集群页面。

导航至集合。

对于要添加数据库引用的集群，单击 Browse Collections。
在左侧导航窗格中，选择数据库。
在左侧导航窗格中，选择该集合。此示例会引用 places 集合。

添加一个文档。

单击 Insert Document（连接）。
单击 JSON 视图图标（{{}}）。
将以下数据粘贴到文档中：
```
{
  "_id": {
    "$oid": "651aea5870299b120736f442"
  },
  "name": "Broadway Center",
  "url": "bc.example.net"
}
```
单击 Insert（连接）。

在 `people` 集合中添加一个文档，并引用 `places` 中的条目。

在左侧导航窗格中，选择其他集合。此示例引用 people 集合。
单击 Insert Document（连接）。
单击 JSON 视图图标（{{}}）。
将以下数据粘贴到文档中：
```
{
  "_id": {
    "$oid": "651aebeb70299b120736f443"
  },
  "name": "Erin",
  "places_id": {
    "$oid": "651aea5870299b120736f442"
  },
  "url": "bc.example.net/Erin"
}
```
单击 Insert（连接）。
当查询从 people 集合返回文档时，您可以根据需要从 places 集合中筛选查询结果，以查找 places_id 字段引用的文档。
要了解在 MongoDB Atlas 中运行查询的更多信息，请参阅 MongoDB Atlas 文档中的查看、过滤文档以及对其进行排序。

在终端中创建手动引用

比如说，以下操作会插入两个文档，使用第一个文档的 _id 字段作为第二个文档中的引用：

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"
})

然后，当查询从 people 集合返回此文档时，可按需对 places 集合中的 places_id 字段引用的文档进行第二次查询。

使用

对于要存储两个文档之间关系的几乎所有情况，请使用手动引用。它们创建起来很简单，应用程序可以根据需要进行解析。

DBRef

背景

DBRef 是一种表示文档的规则，而不是一种特定的引用类型。除了_id字段中的值，它们还包括集合的名称，在某些情况下还包括数据库名称。

或者，DBRef 可以包含任意数量的其他字段。额外字段名称必须遵循服务器版本规定的字段名称规则。

要解析 DBRef，应用程序必须执行额外查询以返回引用的文档。某些MongoDB驱动程序提供了将 DBRef 解析为文档的辅助方法，但解析不是自动进行的。

format

DBRef 具有以下字段：

$ref: $ref 字段包含被引用文档所在集合的名称。

$id: $id 字段包含引用文档中 _id 字段的值。

$db

可选。

包含被引用文档所在数据库的名称。

例子

DBRef 文档与以下文档类似：

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

以某一集合中的某一文档为例，该文档已在 creator 字段中存储 DBRef：

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

此示例中的 DBRef 指向 users 数据库的 creators 集合中的一个文档，该文档的 _id 字段中包含 ObjectId("5126bc054aed4daf9e2ab772")。它还包含一个可选字段。

注意

DBRef 中的字段顺序十分重要，因而在使用 DBRef 时必须使用上述顺序。

驱动程序对 DBRef 的支持情况

驱动	DBRef 支持	注意
C	不受支持	您可以手动遍历引用。
C++	不受支持	您可以手动遍历引用。
C#	受支持	有关详细信息，请参阅.NET/C# 驱动程序页面。
Go	不受支持	您可以手动遍历引用。
Haskell	不受支持	您可以手动遍历引用。
Java	受支持	有关更多信息，请参阅Java 驱动程序页面。
Node.js	受支持	有关更多信息，请参阅Node.js驱动程序页面。
Perl	受支持	有关详细信息，请参阅Perl 驱动程序页面。
PHP	不受支持	您可以手动遍历引用。
Python	受支持	有关更多信息，请参阅PyMongo驱动程序页面。
Ruby	受支持	有关更多信息，请参阅Ruby 驱动程序页面。
Scala	不受支持	您可以手动遍历引用。