Docs 菜单

Docs 主页开发应用程序MongoDB Manual

数据库引用

在此页面上

  • 手动引用
  • 背景
  • 在 MongoDB Atlas 用户界面中创建手动引用
  • 在终端中创建手动引用
  • 使用
  • DBRef
  • 背景
  • format
  • 驱动程序对 DBRef 的支持情况
  • 使用

对 MongoDB 中的许多使用案例而言,将相关数据存储在单个文档中的非规范化数据模型是理想的数据模型。但是,在某些情况下,需要将相关信息存储在单独的文档中,而且一般要存储在不同的集合或数据库中。

重要

本页概述了在 $lookup$graphLookup 管道阶段之前的替代程序。

您可以为以下环境中托管的部署创建数据库引用:

  • MongoDB Atlas :用于在云中部署 MongoDB 的完全托管服务

MongoDB 应用程序使用两种方法之一来关联文档:

  • 手动引用将一个文档的_id字段保存在另一个文档中作为引用。应用程序运行第二个查询以返回相关数据。对于大多数使用案例来说,这些引用简单而充分。

  • DBRef是指使用第一个文档的_id字段的值、集合名称、数据库名称(可选)以及任何其他字段从一个文档到另一个文档的引用。 DBRef 可让您更轻松地引用存储在多个集合或数据库中的文档。

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

DBRefs 提供了一种通用格式和类型来表示文档之间的关系。如果您的数据库必须与多个框架和工具交互,DBRef 格式还提供了表示文档之间链接的通用语义。

除非您有令人信服的理由而要使用 DBRef,否则请使用手动引用。

手动引用是指将一个文档的_id字段包含在另一个文档中的做法。然后,应用程序可视需要发出第二个查询,以解决所引用字段的问题。

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

1
  1. 在 MongoDB Atlas 用户界面中,单击侧边栏中的 Database

  2. 对于要添加数据库引用的数据库部署,单击 Browse Collections

  3. 在左侧导航窗格中,选择数据库。

  4. 在左侧导航窗格中,选择该集合。此示例会引用 places 集合。

2
  1. 单击 Insert Document(连接)。

  2. 单击 JSON 视图图标({{}})。

  3. 将以下数据粘贴到文档中:

    {
    "_id": {
    "$oid": "651aea5870299b120736f442"
    },
    "name": "Broadway Center",
    "url": "bc.example.net"
    }
  4. 单击 Insert(连接)。

3
  1. 在左侧导航窗格中,选择其他集合。此示例引用 people 集合。

  2. 单击 Insert Document(连接)。

  3. 单击 JSON 视图图标({{}})。

  4. 将以下数据粘贴到文档中:

    {
    "_id": {
    "$oid": "651aebeb70299b120736f443"
    },
    "name": "Erin",
    "places_id": "651aea5870299b120736f442"
    "url": "bc.example.net/Erin"
    }
  5. 单击 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字段中的值,它们还包括集合的名称,在某些情况下还包括数据库名称。

作为一个可选项,DBRefs 还可以包括任意数量的其他字段。额外的字段名称必须遵循服务器版本规定的任何字段名称规则

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 支持
注意
C
不受支持
您可以手动遍历引用。
C++
不受支持
您可以手动遍历引用。
C#
受支持
请参阅C# 驱动程序页面以了解更多信息。
Go
不受支持
您可以手动遍历引用。
Haskell
不受支持
您可以手动遍历引用。
Java
受支持
请参阅Java 驱动程序页面以了解更多信息。
Node.js
受支持
请参阅Node.js 驱动程序页面以了解更多信息。
Perl
受支持
请参阅Perl 驱动程序页面以了解更多信息。
PHP
不受支持
您可以手动遍历引用。
Python
受支持
请参阅PyMongo 驱动程序页面以了解更多信息。
Ruby
受支持
请参阅Ruby 驱动程序页面以了解更多信息。
Scala
不受支持
您可以手动遍历引用。

在大多数情况下,您应该使用手动引用方法来连接两个或多个相关文档。但是,如果需要引用多个集合中的文档,请考虑使用 DBRef。

← 数据模型参考
复制 →