**地理区域** 是一组命名的云提供商区域,Atlas 在其中处理您提交给某些 Atlas 服务的内容。地理位置与集群存储数据的云提供商区域无关。
当您必须显示 Atlas 在世界的特定区域内处理特定数据时,请使用地理区域。如果您没有这类要求,则不需要选择地理区域。
地理区域和集群区域
地理区域是您的集群运行所在的云提供商区域的并列概念。这两个边界是独立的,您可以分别设置每个:
区域 决定 Atlas 存储您的集群数据的位置。集群区域是单个云提供商区域,例如
us-west-1或eu-west-2,您在预配集群时选择此区域。地理区域 决定 Atlas 处理您提交给指定服务的内容的位置。推断地理将云提供商区域归入同一司法管辖区。您在配置服务时选择它,它会保持未定义范围的状态,直到您对其进行设置为止。
选择地理区域不会移动您的集群,并且选择集群区域不会限定您的处理范围。由于这两个设置是独立的,因此在评估 Atlas 在何处处理您的数据时,分别查看它们。
要了解集群可用的区域,请参阅 云提供商和区域。
可用地区
Atlas 支持以下地理区域:
地理 | API Value | 地区 | 说明 |
|---|---|---|---|
欧洲 |
| 欧洲经济区 (EEA) | 处理在欧洲经济区内的云提供商区域中运行。 |
United States |
| United States | 处理在美国境内的云提供商区域运行。 |
地理区域内的区域集合可以随时间变化。地理边界本身不会。
指定服务
指定服务是 Atlas 服务,遵循地理范围。当您向指定服务发送带范围的请求时,Atlas 会在地理区域内处理该请求。
下表列出了指定服务及其支持的地理区域:
指定服务 | 欧洲 | United States |
|---|---|---|
Atlas Embedding and Reranking API 服务 | 是 | 是 |
要在某个地理位置内使用Atlas Embedding and Reranking API ,请在创建密钥时将模型API密钥的范围限定为该地理位置。要学习;了解更多信息,请参阅管理 Voyage AI模型API密钥。
自动嵌入和原生重排名也在 Atlas 中运行推理,但是它们尚不支持地理定位。您无法指定 Atlas 处理您提交给这些服务的内容的位置。
地理位置的 ACID 一致性保证
当您使用限定在某个地理区域的模型 API 密钥向指定服务发送请求时,以下承诺适用:
Atlas 处理您在该地理区域内提交的内容。
Atlas 为记录日志而保留的请求负载存储在该地理区域内。
Atlas 会为每个请求加上标签,为其提供服务的地理位置,便于您按地理位置过滤器和 Atlas 审核使用记录和发票。
如果 Geography 无法为请求提供服务,该请求就会失败。Atlas 不会回退到另一个地理区域来为请求提供服务。
由于范围请求会失败而不是在其他地方运行,请设计应用程序以重试失败的请求,并采用退避策略,同时在客户端设置重试预算。请勿失败转移到不同地理区域的终结点,除非该地理区域中的处理对于您的使用案例是可接受的。
地理区域限制 Atlas 处理您内容的位置,而不是您的帐户。无论您选择什么地理区域,账户管理、密钥管理、资源策略、计费和使用元数据都在全球运行。这个全局元数据不包含您提交以供处理的内容。
选择地理区域
使用未范围模型 API 密钥,除非您必须证明 Atlas 在世界的某个特定区域内处理特定数据。无范围密钥适用于 ai.mongodb.com,利用最大的容量池,并且不受付费使用层级的限制。
在为密钥指定地理区域之前,请注意以下事项:
Atlas 对您发送到范围终结点的代币收取 10% 的附加费。
在创建密钥时设置地理区域,之后无法更改。要使用不同的 Geography,请创建新密钥。
您的组织可以要求在给定地理位置创建新模型API密钥。要学习;了解更多信息,请参阅管理 Voyage AI模型API密钥。
了解详情
要了解 Atlas 支持集群的云提供商和区域,请参阅云提供商和区域。