数据库和集合

时间序列集合

时间序列集合可有效存储一段时间内的测量序列。 以下示例创建了一个名为 example_ts_collection 的时间序列集合，其中文档的时间字段名为 timestamp：

database = client["test_database"]
database.create_collection("example_ts_collection", timeseries={"timeField": "timestamp"})

有关通过PyMongo使用时间序列数据的更多信息，请参阅时间序列数据指南。

固定大小集合

您可以创建固定大小集合，但该集合的增长不能超过指定的内存大小或文档计数。 以下示例创建了一个名为 example_capped_collection 的固定大小集合，其最大大小为 1000 字节：

database = client["test_database"]
database.create_collection("example_capped_collection", capped=True, size=1000)

要学习；了解有关固定大小集合的更多信息，请参阅MongoDB Server手册中的固定大小集合。

Database

如果数据库中的所有文档都匹配定义明确的模式，则可以指定使用Python类来表示文档结构的类型提示。通过在 Database对象的类型提示中包含此类，可以确保存储或检索的所有文档都具有所需的结构。与默认的Dict[str, Any] 类型相比，这提供了更准确的类型检查和代码完成。

首先，定义一个类来表示数据库中的文档。该类必须从 TypedDict 类继承，并且必须包含与数据库中的文档相同的字段。定义类后，将其名称作为 Database 类型提示的泛型类型。

以下示例定义了一个 Movie 类，并将其用作 Database 类型提示的泛型类型：

from typing import TypedDict
from pymongo import MongoClient
from pymongo.database import Database
class Movie(TypedDict):
    name: str
    year: int
client: MongoClient = MongoClient()
database: Database[Movie] = client["test_database"]

Collection

向 Collection 类型提示添加泛型类型与向 Database 类型提示添加泛型类型类似。首先，定义一个类，它从 TypedDict 类继承并表示集合中文档的结构。然后，将类名称作为泛型类型包含在 Collection 类型提示中，如以下示例所示：

from typing import TypedDict
from pymongo import MongoClient
from pymongo.collection import Collection
class Movie(TypedDict):
    name: str
    year: int
client: MongoClient = MongoClient()
database = client["test_database"]
collection: Collection[Movie] = database["test_collection"]

客户端类型注解

如果没有为 MongoClient对象添加类型注解，类型检查器可能会显示类似于以下内容的错误：

from pymongo import MongoClient
client = MongoClient()  # error: Need type annotation for "client"

解决方案是将 MongoClient对象注释为 client: MongoClient 或 client: MongoClient[Dict[str, Any]]。

不兼容类型

如果您指定 MongoClient 作为类型提示，但不包含文档、键和值的数据类型，则类型检查器可能会显示类似于以下内容的错误：

error: Dict entry 0 has incompatible type "str": "int";
expected "Mapping[str, Any]": "int"

解决方案是将以下类型提示添加到 MongoClient对象：

``client: MongoClient[Dict[str, Any]]``

AutoReconnect 错误

如果您在读取偏好中指定tag-sets ，并且 MongoDB 无法找到具有指定标签的副本集成员，您会收到此错误。 要避免此错误，请在标签集列表的末尾包含一个空字典 ( {} )。 这指示 PyMongo 在找不到匹配标签时，从任何与读取引用模式匹配的成员中读取。