地理位置是一个命名的云提供商区域群组, Atlas在其中处理您提交到某些Atlas服务的内容。地理位置独立于集群存储数据的云提供商地区。
当您必须证明Atlas在世界特定地区处理特定数据时,请使用地理位置。如果您没有这样的要求,则无需选择地理位置。
注意
公开预览版
“欧洲地理”功能作为公共预览功能提供。在预览期间,功能和相应的文档可能随时更改。
地理位置和集群区域
地理位置是集群运行所在的云提供商地区的同级概念。这两个边界是独立的,需要单独设立:
地区控制Atlas存储集群数据的位置。集群地区是您在预配集群时选择的单个云提供商地区,例如
us-west-1或eu-west-2。地理位置控制Atlas处理您提交到指定服务的内容的位置。推断地理位置将云提供商区域分组在一个管辖范围内。您在配置服务时选择它,在设立之前它保持无范围状态。
选择地理位置不会移动集群,选择集群地区也不会确定处理。由于这两个设置是独立的,因此在评估Atlas处理数据的位置时单独查看它们。
要学习;了解可用于集群的地区,请参阅 Cloud Providers and Regions(云提供商和地区)。
可用地区
Atlas支持以下地理位置:
地理 | API Value | 地区 | 说明 |
|---|---|---|---|
欧洲 |
| 欧洲经济区 (EEA) | 处理在 EEA 内的云提供商区域中运行。 |
United States |
| 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,利用最大的容量池,并且不受付费使用层级的限制。
在将键的范围限定为地理位置之前,请注意以下事项:
Atlas会对您发送到限定范围的端点的令牌收取 10% 的加成。
您可以在创建密钥时设立地理位置,之后无法更改。要使用不同的地理位置,请创建一个新密钥。