对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

Atlas中的地理位置和指定服务

地理位置是一个命名的云提供商区域群组, Atlas在其中处理您提交到某些Atlas服务的内容。地理位置独立于集群存储数据的云提供商地区。

当您必须证明Atlas在世界特定地区处理特定数据时,请使用地理位置。如果您没有这样的要求,则无需选择地理位置。

注意

公开预览版

“欧洲地理”功能作为公共预览功能提供。在预览期间,功能和相应的文档可能随时更改。

地理位置是集群运行所在的云提供商地区的同级概念。这两个边界是独立的,需要单独设立:

  • 地区控制Atlas存储集群数据的位置。集群地区是您在预配集群时选择的单个云提供商地区,例如us-west-1eu-west-2

  • 地理位置控制Atlas处理您提交到指定服务的内容的位置。推断地理位置将云提供商区域分组在一个管辖范围内。您在配置服务时选择它,在设立之前它保持无范围状态。

选择地理位置不会移动集群,选择集群地区也不会确定处理。由于这两个设置是独立的,因此在评估Atlas处理数据的位置时单独查看它们。

要学习;了解可用于集群的地区,请参阅 Cloud Providers and Regions(云提供商和地区)。

Atlas支持以下地理位置:

地理
API Value
地区
说明

欧洲

eu

欧洲经济区 (EEA)

处理在 EEA 内的云提供商区域中运行。

United States

us

United States

处理在美国境内的云提供商地区运行。

地理区域内的区域设立可能会随时间而变化。地理边界本身没有。

指定服务是支持地理范围的Atlas服务。当您向指定服务发送限定范围的请求时, Atlas会在地理区域内处理该请求。

下表列出了指定服务以及每项服务支持的地理位置:

指定服务
欧洲
United States

Atlas嵌入和重新排名API服务

要在某个地理位置内使用Atlas Embedding and Reranking API ,请在创建密钥时将模型API密钥的范围限定为该地理位置。要学习;了解更多信息,请参阅模型API密钥。

自动嵌入和原生重排名也会在Atlas中运行推理,但尚不支持地理位置定位。您无法确定Atlas处理您提交到这些服务的内容的范围。

当您使用范围为某个地理位置的模型API密钥向指定服务发送请求时,以下承诺成立:

  • Atlas会处理您在该地理位置内提交的内容。

  • Atlas保留用于日志记录的请求有效负载存储在该地理位置中。

  • Atlas为每个请求标记了为该请求提供服务的地理位置,因此您可以按地理位置过滤和Atlas 审核使用记录和发票。

  • 如果地理区域无法为请求提供服务,则请求将失败。 Atlas不会回退到另一个地理位置来提供服务请求。

由于限定范围的请求会失败而不是在其他地方运行,因此请将应用程序设计为带回退的重试失败请求,并在客户端上设立重试预算。除非您的使用案例可以接受在该地理位置处理,否则请勿故障转移到其他地理位置的端点。

地理位置限制了Atlas处理内容的位置,而不是帐户的位置。无论您选择哪个地理位置,帐户管理、密钥管理、资源策略、计费和使用情况元数据都会在全球范围内运行。此全局元元数据不包含您提交进行处理的内容。

使用未限定范围的模型API密钥,除非您必须证明Atlas可在世界特定地区处理特定数据。未指定作用域的密钥适用于 ai.mongodb.com,利用最大的容量池,并且不受付费使用层级的限制。

在将键的范围限定为地理位置之前,请注意以下事项:

您的组织可以要求在给定地理位置创建新模型API密钥。要学习;了解更多信息,请参阅模型API密钥。