修改查询结果

样本数据

本指南中的示例使用 Band 模型，该模型表示乐队或音乐群组。 每个部分的 Band 模型的定义可能不同，以演示不同的查询功能。 某些部分还使用 Manager 模型（表示给定乐队的管理人员）或 Tour 模型（表示给定乐队的现场表演）。

包含字段

only 方法只从数据库中检索指定字段。

以下代码仅返回 members字段值为 4 的文档中的 name字段：

Band.where(members: 4).only(:name)

如果尝试引用尚未加载的属性，Mongoid 会引发 Mongoid::Errors::AttributeNotLoaded 错误。

您还可以使用 only 方法包含嵌入式文档中的字段。

假设 Band 模型嵌入了多个 Tour 对象。 您可以项目Tour 模型中的字段，例如 year，如以下代码所示：

bands = Band.only(:name, 'tours.year')

然后，您可以从返回的文档访问权限嵌入式字段：

# Returns the first Tour object from
# the first Band in the results
bands.first.tours.first

您可以将引用关联的字段传递给 only 方法，但在加载嵌入式对象时会忽略投影。 Mongoid 加载引用关联的所有字段。 示例，当您访问权限前面代码中所示的嵌入式 Tour对象时，Mongoid 返回完整的对象，而不仅仅是 year字段。

如果文档包含 has_one 或 has_and_belongs_to_many 关联，并且您希望 Mongoid 在调用 only 方法时加载这些关联，则必须在属性列表中包含带有外键的字段。

在以下示例中，Band 和 Manager 模型具有 has_and_belongs_to_many 关联：

class Band
  include Mongoid::Document
  field :name, type: String
  has_and_belongs_to_many :managers
end
class Manager
  include Mongoid::Document
  has_and_belongs_to_many :bands
end

以下代码演示了如果包含 manager_ids字段， Mongoid 如何加载关联的 Manager 对象：

# Returns null
Band.where(name: 'Astral Projection').only(:name).first.managers
# Returns the first Manager object
Band.where(name: 'Astral Projection').only(:name, :manager_ids).first.managers

排除字段

您可以使用 without 方法从结果中明确排除字段。

以下代码从返回的 Band 对象中排除 year字段：

Band.where(members: 4).without(:year)

限制结果数量

您可以使用 limit 方法来限制 Mongoid 返回的结果数量。

以下代码最多检索 5 个文档：

Band.limit(5)

Band.take(5)

跳过结果

您可以使用 skip 方法或其别名 offset 跳过指定数量的结果。

如果将 limit 调用链接到 skip，则在跳过文档后应用限制，如以下示例所示：

Band.skip(2).limit(5)
# Skips the first two results and returns
# the following five results

以下代码在返回结果时跳过前 3 个文档：

Band.skip(3)
# Equivalent
Band.offset(3)

生成结果批次

执行大型查询以及使用Criteria#each 等枚举器方法迭代查询结果时，Mongoid 会自动使用MongoDB getMore 命令分批加载结果。默认批处理大小为 1000，但您可以使用 batch_size 方法设立不同的值。

以下代码将批处理大小设置为 500：

Band.batch_size(500)

include 方法

includes 方法使用针对每个关联的单独查询来加载关联。以下代码使用单独的查询加载乐队及其关联的专辑和标签：

Band.where(name: 'The Beatles').includes({ albums: :songs }, :labels).first

当您使用 includes 方法时，Mongoid 会对基类运行查询以获取所有基本文档，然后为其预先加载的每个关联运行单独查询。

上一个示例执行了以下查询：

• 查找 Band 文档的一个查询

• 一个查询即可加载关联的 Album 文档

• 一个查询即可加载关联的 Label 文档

• 一个查询即可加载关联的 Song 文档

ager_load 方法

eager_load 方法使用带有 $lookup 操作符的MongoDB聚合管道在单个查询中加载所有关联。以下代码使用单个聚合管道查询来加载乐队及其关联的专辑和标签，每个关联有 $lookup 个阶段：

Band.where(name: 'The Beatles').eager_load({ albums: :songs }, :labels).first

性能考虑因素

includes 和 eager_load 方法都执行预先加载，但执行方式不同。includes 方法对基本文档运行一次查询，然后对每个关联进行单独查询。eager_load 方法使用具有 $lookup 个阶段的单个聚合管道来加载关联。

与 includes 相比，eager_load 方法执行的查询更少，使用的内存也更少。但是，该方法的效率因文档中的关联类型而异：

• eager_load 对于 has_many、has_and_belongs_to_many 更快，并且在大多数数据集上加载多个关联

• includes 在大多数数据集上，belongs_to、has_one 和嵌套关联的速度更快

选择最适合您的使用案例和关联类型的方法。