Uma localidade geográfica é um grupo nomeado de regiões do provedor de nuvem dentro do qual o Atlas processa o conteúdo que você envia a determinados serviços do Atlas . Uma localização geográfica é independente da região do provedor de nuvem onde seu cluster armazena dados.
Use uma localização geográfica quando precisar mostrar que o Atlas processa dados específicos em uma parte específica do mundo. Se você não tiver esse requisito, não precisará selecionar uma localidade.
Observação
Visualização pública
A região geográfica da Europa está disponível como um recurso de visualização pública. O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização.
Geograficamente e regiões de cluster
Uma localidade é um conceito semelhante ao da região do provedor de nuvem onde seu cluster é executado. Os dois limites são independentes e você define cada um separadamente:
A região controla onde o Atlas armazena os dados do seu cluster. A região do cluster é uma única região de provedor de nuvem , como
us-west-1eu-west-2ou, que você escolhe quando provisiona um cluster.Uma geográfica rege onde o Atlas processa o conteúdo que você envia para um serviço designado. A inferência geográfica agrupa regiões de provedor de nuvem sob uma autoridade . Você o seleciona ao configurar o serviço e ele permanece sem escopo até que você o defina.
Escolher uma localidade geográfica não move seu cluster, e a escolha de uma região de cluster não tem escopo de seu processamento. Como essas duas configurações são independentes, revise-as separadamente ao avaliar onde o Atlas processa seus dados.
Para saber mais sobre as regiões disponíveis para seu cluster, consulte Provedores e regiões de nuvem.
Geogeografias disponíveis
O Atlas é compatível com as seguintes regiões geográficas:
Geograficamente | API Value | Regiões | Descrição |
|---|---|---|---|
Europa |
| Espaço Econômico Europeu (EEE) | O processamento é executado em regiões do provedor de nuvem dentro do EEE. |
Estados Unidos |
| Estados Unidos | O processamento é executado em regiões de provedor de nuvem dentro dos Estados Unidos. |
O conjunto de regiões dentro de uma geográfica pode mudar ao longo do tempo. O limite geográfico em si não.
Serviços designados
Um Serviço Designado é um serviço Atlas que honra um escopo geográfico. Quando você envia uma solicitação com escopo para um Serviço Designado, o Atlas processa essa solicitação dentro da Região geográfica.
A tabela a seguir lista os Serviços designados e as localidades geográficas que cada um oferece suporte:
Serviço designado | Europa | Estados Unidos |
|---|---|---|
Serviço de API de incorporação e reclassificação do Atlas | Sim | Sim |
Para consumir a API de Incorporação e Reclassificação do Atlas em uma Geograficamente, você define o escopo de uma chave de API de modelo para essa Geograficamente ao criar a chave. Para saber mais, consulte Chaves de API do modelo.
A Incorporação Automática e a Reclassificação Nativa também executam inferência no Atlas, mas ainda não suportam a segmentação geográfica. Você não pode definir o escopo onde o Atlas processa o conteúdo enviado a esses serviços.
O que a localização geográfica garante
Quando você envia uma solicitação para um Serviço designado usando uma chave de API de modelo com escopo para uma localidade geográfica, os seguintes compromisso são mantidos:
O Atlas processa o conteúdo que você envia dentro dessa localidade.
As cargas úteis da solicitação que o Atlas retém para registro são armazenadas dentro dessa localidade.
O Atlas marca cada solicitação com a localização geográfica que a atendeu, para que você possa filtrar e auditar os registros de uso e as faturas por região geográfica.
Se a localização geográfica não puder atender a uma solicitação, a solicitação falhará. O Atlas não utiliza outra localidade geográfica para atender à solicitação.
Como uma solicitação com escopo falha em vez de ser executada em outro lugar, crie seu aplicação para tentar novamente as solicitações com falha com backoff e definir um orçamento de novas tentativas para seu cliente. Não faça failover para um endpoint de localização geográfica diferente, a menos que o processamento nessa localização geográfica seja aceitável para seu caso de uso.
Uma restrição geográfica onde o Atlas processa seu conteúdo, não sua conta. O gerenciamento de contas, o gerenciamento de chaves, as políticas de recursos, a cobrança e o uso de metadados operam globalmente, independentemente da região geográfica que você escolher. Esses metadados globais não contêm o conteúdo que você envia para processamento.
Escolher uma localização geográfica
Use uma chave de API de modelo sem escopo, a menos que você precise demonstrar que o Atlas processa dados específicos em uma parte específica do mundo. As chaves sem escopo funcionam contra ai.mongodb.com, utilizam o maior pool de capacidade e não estão restritas a um nível de uso pago.
Antes de definir o escopo de uma chave para uma geográfica, observe o seguinte:
O Atlas cobra um aumento de 10% nos tokens que você envia para um endpoint com escopo.
Os endpoints com escopo exigem um nível de uso pago. Para saber mais, consulte Níveis de uso.
Os endpoints com escopo têm seus próprios limites de taxa, que são inferiores aos do endpoint sem escopo. Para saber mais, consulte Gerenciar Limites de Taxa.
Você define a geográfica ao criar a chave e não pode alterá-la depois. Para usar uma geográfica diferente, crie uma nova chave.
Sua organização pode exigir que novas chaves de API de modelo sejam criadas em uma determinada localidade. Para saber mais, consulte Chaves de API do modelo.
Saiba mais
Para saber como as geográficas se aplicam à API de incorporação e reclassificação do Atlas , incluindo pontos de extremidade geográficos, limites de taxa e modelos disponíveis, consulte Geographies for Voyage AI Inference na documentação da Voyage AI.
Para saber mais sobre os provedores de nuvem e regiões que o Atlas suporta para clusters, consulte Provedores de nuvem e regiões.