作为副本集连接到 Amazon DocumentDB - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

作为副本集连接到 Amazon DocumentDB

在使用 Amazon DocumentDB 进行开发时,我们建议您以副本集形式连接到集群,并使用驱动程序的内置读取首选项功能将读取操作分布到副本实例。本节将更深入地介绍这意味着什么,并介绍如何使用适用于 Python 的软件开发工具包作为副本集连接到 Amazon DocumentDB 集群。

Amazon DocumentDB 具有三个终端节点,您可以使用它们连接到您的集群:

  • 集群终端节点

  • 读取器终端节点

  • 实例终端节点

在大多数情况下,当您连接到 Amazon DocumentDB 时,我们建议您使用集群终端节点。这是指向集群中的主实例的 CNAME,如下图所示。

使用 SSH 隧道时,我们建议您使用集群终端节点连接到集群,而不要尝试以副本集模式(即在连接字符串中指定 replicaSet=rs0)进行连接,因为这会导致错误。

注意

有关 Amazon DocumentDB 终端节点的更多信息,请参阅Amazon DocumentDB 终端节点


         显示了 Amazon DocumentDB 终端节点,包括集群、读取器和实例终端节点。

使用集群终端节点,您可以以以副本集模式连接到您的集群。然后,您可以使用内置的读取首选项驱动程序功能。在下面的示例中,指定/?replicaSet=rs0表示您要以副本集形式连接到的开发工具包。如果省略/?replicaSet=rs0'时,客户端会将所有请求路由到集群终端节点,即您的主实例。

## Create a MongoDB client, open a connection to Amazon DocumentDB as a ## replica set and specify the read preference as secondary preferred client = pymongo.MongoClient('mongodb://<user-name>:<password>@mycluster.node.us-east-1.docdb.amazonaws.com:27017/?replicaSet=rs0')

作为副本集进行连接的优点在于,它使 SDK 能够自动发现集群拓扑,包括在从集群中添加或删除实例时。然后,您可以通过将读取请求路由到副本实例来更有效地使用集群。

作为复制副本集进行连接时,可以指定readPreference用于连接。如果指定读取首选项secondaryPreferred,客户端将读取查询路由到您的副本,并将查询写入主实例(如下图所示)。这可以更好地利用您的群集资源。有关更多信息,请参阅 读取首选项选项

## Create a MongoDB client, open a connection to Amazon DocumentDB as a ## replica set and specify the read preference as secondary preferred client = pymongo.MongoClient('mongodb://<user-name>:<password>@mycluster.node.us-east-1.docdb.amazonaws.com:27017/?replicaSet=rs0&readPreference=secondaryPreferred')

         显示 Amazon DocumentDB readPreference 的图表:secondaryPreferred。

对 Amazon DocumentDB 副本的读取操作具有最终一致性。它们返回数据的顺序与在主数据库上写入的顺序相同,并且复制滞后通常不到 50 毫秒。您可以使用 Amazon CloudWatch 指标监控集群的副本滞后DBInstanceReplicaLagDBClusterReplicaLagMaximum。有关更多信息,请参阅 使用 CloudWatch 监控 Amazon DocumentDB dWatch

与传统的整体数据库体系结构不同,Amazon DocumentDB 将存储和计算分开。鉴于这种现代体系结构,我们鼓励您在副本实例上读取规模。对副本实例的读取不会阻止从主实例复制写入。您可以在群集中添加多达 15 个只读副本实例,并向外扩展到每秒数百万次读取。

作为副本集进行连接并将读取分发到副本的主要好处是,它会增加群集中可用于为应用程序执行工作的总体资源。作为最佳实践,我们建议您以副本集形式进行连接。此外,在以下情况下,我们最常推荐它:

  • 您在主机上使用了近 100% 的 CPU。

  • 缓冲区缓存命中率接近零。

  • 您已达到单个实例的连接或游标限制。

扩大集群实例大小是一个选项,在某些情况下,这可能是扩展集群的最佳方法。但是,您还应该考虑如何更好地使用群集中已有的副本。这样,您就可以在不增加使用更大实例类型的成本的情况下增加扩展。我们还建议您监控和警报这些限制(即CPUUtilizationDatabaseConnections, 和BufferCacheHitRatio)使用 CloudWatch 警报,以便您知道资源何时被大量使用。

有关更多信息,请参阅以下主题:

使用群集连接

请考虑使用集群中所有连接的情况。例如,r5.2xlarge实例的连接数限制为 4,500(以及 450 个打开的游标)。如果您创建了三个实例的 Amazon DocumentDB 集群,并且只使用集群终端节点连接到主实例,则打开的连接和游标的集群限制分别为 4,500 和 450。如果您正在构建的应用程序要使用许多在容器中启动的工作程序,那么可能会达到这些限制。容器一次打开多个连接并使集群饱和。

相反,您可以作为副本集连接到 Amazon DocumentDB 集群,并将您的读取内容分发到副本实例。然后,您可以有效地将群集中可用的可用连接和游标数量增加三倍,分别达到 13,500 和 1,350。向集群添加更多实例只会增加读取工作负载的连接和游标数。如果您需要增加写入集群的连接数量,我们建议您增加实例大小。

注意

的连接数largexlarge, 和2xlarge实例会随实例大小增加到 4,500。每个实例的最大连接数4xlarge实例或更高的值为 4,500。有关实例类型限制的更多信息,请参阅实例限制

一般而言,我们不建议使用 secondary 的读取首选项连接到集群。这是因为如果集群中没有副本实例,则读取操作将失败。例如,假设您具有具有一个主集群和一个副本的双个实例 Amazon DocumentDB 集群。如果复制副本有问题,请从设置为secondary失败。的优势secondaryPreferred是,如果客户端找不到要连接到的合适副本实例,则会回退到主实例进行读取。

多个连接池

在某些情况下,应用程序中的读取需要具有写后读取一致性,这只能从 Amazon DocumentDB 中的主实例提供。在这些情况下,您可能会创建两个客户端连接池:一个用于写入,另一个用于需要写后读取一致性的读取。要做到这一点,您的代码将类似于下文。

## Create a MongoDB client, ## open a connection to Amazon DocumentDB as a replica set and specify the readPreference as primary clientPrimary = pymongo.MongoClient('mongodb://<user-name>:<password>@mycluster.node.us-east-1.docdb.amazonaws.com:27017/?replicaSet=rs0&readPreference=primary') ## Create a MongoDB client, ## open a connection to Amazon DocumentDB as a replica set and specify the readPreference as secondaryPreferred secondaryPreferred = pymongo.MongoClient('mongodb://<user-name>:<password>@mycluster.node.us-east-1.docdb.amazonaws.com:27017/?replicaSet=rs0&readPreference=secondaryPreferred')

另一种选择是创建单个连接池并覆盖给定集合的读取首选项。

##Specify the collection and set the read preference level for that collection col = db.review.with_options(read_preference=ReadPreference.SECONDARY_PREFERRED)

Summary

要更好地使用集群中的资源,我们建议您使用副本集模式连接到您的集群。如果它适合您的应用程序,则可以通过将读取内容分发到副本实例来读取扩展应用程序。