.only('field_name') 的作用

在使用 mongoengine 的 QuerySet 时，.only('field_name') 是一种优化查询的方法，用于指定只查询某些字段的数据。以下是其工作原理及返回的内容：

.only('field_name') 的作用

它限制 MongoDB 查询返回的字段，仅获取指定的字段内容。用于提高查询性能，减少不必要的数据加载。

示例

`results = MyDocument.objects.only('ip')`

具体效果：

返回的是一个 QuerySet，其中的每个文档只包含 ip 字段（以及默认的 _id 字段）。
其他字段的值不会被加载到内存中，访问它们时会抛出 mongoengine.errors.ValidationError。

返回内容

返回的对象类型：QuerySet，包含符合条件的文档。

文档的字段：

只包含 ip 和默认的 _id 字段。

访问字段：

for doc in results:
    print(doc.ip)  # 可以正常访问 `ip` 字段
    print(doc.id)  # `_id` 字段总是存在
    print(doc.other_field)  # 访问未加载的字段会报错

定义文档模型

from mongoengine import Document, StringField, IntField

class MyDocument(Document):
    ip = StringField()
    name = StringField()
    age = IntField()

查询数据

假设有如下数据：

{ "_id": ObjectId("..."), "ip": "192.168.0.1", "name": "Alice", "age": 30 }

只查询 ip 字段

results = MyDocument.objects.only('ip')

遍历查询结果

for doc in results:
print(doc.ip) # 输出: 192.168.0.1
print(doc.id) # 输出: 文档的 _id
# print(doc.name) # 报错: ValidationError，因为 name 字段未被加载

注意事项

无法访问未加载的字段：
通过 .only('field') 限制返回字段后，未指定的字段将不可访问。
如果尝试访问未加载的字段，会抛出 ValidationError。

_id 字段默认返回：

MongoDB 的 _id 字段是默认加载的，即使未显式指定，它也会包含在结果中。

组合使用：

可以指定多个字段：

results = MyDocument.objects.only('ip', 'name')
性能优化：

.only() 对于大型文档的性能优化尤为明显，因为它避免了加载所有字段。

适用场景
减少网络传输量：在查询大型文档时，只获取必要的字段。
优化性能：避免加载不需要的字段，减少内存占用。
特定字段操作：当你只需要某几个字段用于展示或计算时。
### 例如，在日志系统中，你可能只需要查询 IP 地址来统计访问情况：

ip_list = [doc.ip for doc in MyDocument.objects.only('ip')]