Uma Geografia é um grupo nomeado de regiões de provedores de nuvem dentro do qual o Atlas processa o conteúdo que você envia para determinados serviços do Atlas. Uma geografia é independente da região do provedor de nuvem onde seu cluster armazena dados.
Use uma Geografia quando você 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 Geografia.
Geografias e regiões de cluster
Uma Geografia é um conceito irmão 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 determina 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-1oueu-west-2, que você escolhe durante o provisionamento de um cluster.Uma Geografia governa onde o Atlas processa o conteúdo que você envia para um Serviço Designado. A Geografia de inferência agrupa regiões de provedores de nuvem sob uma única jurisdição. Você o seleciona ao configurar o serviço, e ele permanece não definido até que você o configure.
Escolher uma Geography não move seu cluster, e escolher uma região de cluster não define o escopo do seu em processamento. Como essas duas configurações são independentes, revise-as separadamente ao avaliar onde o Atlas processa seus dados.
Para aprender sobre as regiões disponíveis para seu cluster, consulte Provedores de nuvem e regiões.
Geografias disponíveis
O Atlas oferece suporte às seguintes Geografias:
Geograficamente | API Value | Regiões | Descrição |
|---|---|---|---|
Europa |
| Espaço Econômico Europeu (EEA) | O processamento executa em regiões de provedores de nuvem dentro do EEE. |
Estados Unidos |
| Estados Unidos | O em processamento executa em regiões de provedores de nuvem dentro dos Estados Unidos. |
O conjunto de regiões dentro de uma Geografia pode mudar com o tempo. O próprio limite de Geografia não.
Serviços Designados
Um Serviço Designado é um serviço Atlas que respeita um escopo de Geografia. Quando você envia uma solicitação com escopo para um Serviço Designado, o Atlas processa essa solicitação dentro da Geografia.
A tabela a seguir lista os Serviços Designados e as Geografias que cada um deles oferece suporte:
Serviço Designado | Europa | Estados Unidos |
|---|---|---|
Atlas Embedding and Reranking API Serviço | 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 Gerenciar chaves de API do modelo Voyage AI.
O embedding automatizado e a reclassificação nativa também executam inferência no Atlas, mas eles não oferecem suporte para segmentação geográfica ainda. Você não pode definir o escopo onde o Atlas processa o conteúdo que você envia para esses serviços.
O que uma geografia garantias
Quando você envia uma solicitação para um Designated Service usando uma model API key com escopo para uma Geography, os seguintes compromissos são válidos:
O Atlas processa o conteúdo que você envia dentro dessa Geografia.
As cargas útil de solicitação que o Atlas retém para registro são armazenadas dentro dessa Geografia.
O Atlas marca cada solicitação com a tag da Geografia que a serviu, para que você possa aplicar o filtro e auditar registros de uso e faturas por Geografia.
Se a Geografia não conseguir servir uma solicitação, a solicitação falha. O Atlas não recorre a outra Geografia para servir à solicitação.
Como uma solicitação com escopo falha em vez de ser executada em outro lugar, projete seu aplicativo para repetir as solicitações com falha com espera exponencial e para definir um orçamento de repetição no seu cliente. Não faça failover para um ponto de extremidade de uma geografia diferente, a menos que em processamento nessa geografia seja aceitável para o seu caso de uso.
Uma geografia restringe onde o Atlas processa seu conteúdo, não sua conta. O gerenciamento de contas, o gerenciamento de chaves, as políticas de recursos, o faturamento e os metadados de uso operam globalmente, independentemente da geografia que você escolher. Estes metadados globais não contêm o conteúdo que você envia para em processamento.
Escolhendo uma Geografia
Use uma chave API de modelo sem escopo, a menos que você precise demonstrar que o Atlas processa dados específicos em uma determinada parte do mundo. As chaves sem escopo funcionam contra ai.mongodb.com, utilizam o maior pool de capacidade e não são restritas a um tier de uso pago.
Antes de definir o escopo de uma chave para uma Geografia, observe o seguinte:
O Atlas cobra uma sobretaxa de 10% sobre os tokens que você envia para um ponto de extremidade 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 Geografia ao criar a chave e não pode alterá-la depois. Para usar uma Geografia 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 Gerenciar chaves de API do modelo Voyage AI.
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 aprender mais sobre os provedores de nuvem e as regiões que o Atlas suporta para clusters, consulte Provedores de nuvem e regiões.