지역은 사용자가 특정 Atlas 서비스에 제출 콘텐츠를 Atlas 처리하는 명명된 cloud 제공자 리전 그룹 입니다. 지리적 위치는 클러스터 데이터를 저장하는 cloud 제공자 리전 과 독립적입니다.
Atlas 특정 지역 내에서 특정 데이터를 처리한다는 것을 보여야 하는 경우 지리를 사용하세요. 이러한 요구 사항이 없는 경우 지역을 선택할 필요가 없습니다.
참고
공개 미리보기
유럽 지리 는 공개 미리 보기 기능 으로 사용할 수 있습니다. 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다.
지역 및 클러스터 리전
지리적 위치는 클러스터 실행되는 cloud 제공자 리전 의 형제 개념입니다. 두 경계는 독립적이며 각각을 별도로 설정하다 .
리전 Atlas 가 클러스터의 데이터를 저장하는 위치를 관리합니다. 클러스터 리전 클러스터 프로비저닝할
us-west-1eu-west-2때 선택하는 또는 와 같은 단일 cloud 제공자 리전 입니다.지리적 위치는 사용자가 지정 서비스에 제출 콘텐츠를 Atlas 처리하는 위치를 결정합니다. 추론 지리 는 cloud 제공자 리전을 하나의 관할 구역으로 그룹화합니다. 서비스를 구성할 때 선택하면 설정하다 때까지 범위가 지정되지 않습니다.
지역을 선택해도 클러스터 이동하지 않으며, 클러스터 리전 을 선택해도 처리 범위가 지정되지 않습니다. 이 두 설정은 독립적이므로 Atlas 데이터를 처리하는 위치를 평가할 때 별도로 검토 .
클러스터 에 사용할 수 있는 리전에 대해 학습 클라우드 제공자 및 리전을 참조하세요.
사용 가능한 지역
Atlas 다음과 같은 지역을 지원합니다.
지리 | API Value | 리전 | 설명 |
|---|---|---|---|
유럽 |
| 유럽 경제 지역(EEA) | 처리는 EEA 내의 cloud 제공자 리전에서 실행됩니다. |
미국 |
| 미국 | 처리는 미국 내의 cloud 제공자 리전에서 실행됩니다. |
지리 내의 리전 설정하다 는 시간이 지남에 따라 변경될 수 있습니다. 지리적 경계 자체는 그렇지 않습니다.
지정 서비스
지정 서비스는 지리적 범위를 준수하는 Atlas 서비스입니다. 지정 서비스에 범위 지정 요청 보내면 Atlas 지리 내에서 해당 요청 처리합니다.
다음 표에는 각 지정 서비스가 지원하는 지정 서비스 및 지역이 나열되어 있습니다.
지정 서비스 | 유럽 | 미국 |
|---|---|---|
Atlas Embedding 및 Reranking API 서비스 | 예 | 예 |
지리 내에서 Atlas 임베딩 및 API 재지정을 사용하려면 키를 생성할 때 모델 API 키의 범위를 해당 지리로 지정합니다. 자세한 학습 은 ManageVoyage AI Model API Keys(Voyage AI 모델 API 키 관리)를 참조하세요.
자동 임베딩 및 네이티브 재순위 지정도 Atlas 에서 추론을 실행 하지만, 아직 지역 타겟팅을 지원 하지 않습니다. 이러한 서비스에 제출 콘텐츠를 Atlas 처리하는 위치의 범위를 지정할 수 없습니다.
지리적 보장
지리적 범위가 지정된 모델 API 키를 사용하여 지정 서비스에 요청 전송하면 다음과 같은 약정이 적용됩니다.
Atlas 사용자가 해당 지역 내에서 제출 콘텐츠를 처리합니다.
Atlas 로깅을 위해 보관하는 요청 페이로드는 해당 지리 내에 저장됩니다.
Atlas 모든 요청 에 해당 요청을 제공한 지역으로 태그를 지정하므로 사용 기록 및 청구서를 지역별로 필터하다 하고 감사 할 수 있습니다.
지역에서 요청 제공 할 수 없는 경우 요청 이 실패합니다. Atlas 요청 제공 위해 다른 지리적 위치로 대체되지 않습니다.
범위 지정 요청 다른 곳에서 실행 대신 실패하므로 백오프를 통해 실패한 요청을 재시도하고 클라이언트 에 재시도 예산을 설정하다 하도록 애플리케이션 설계합니다. 사용 사례 에 따라 해당 지역에서의 처리 허용되는 경우가 아니라면 다른 지역의 엔드포인트로 페일오버하지 마세요.
지리적 위치는 Atlas 계정이 아닌 콘텐츠를 처리하는 위치를 제한합니다. 계정 관리, 키 관리, 리소스 정책, 청구 및 사용량 메타데이터 선택한 지역에 관계없이 전 세계에서 작동합니다. 이 글로벌 메타데이터 처리 위해 제출 콘텐츠가 포함되어 있지 않습니다.
지역 선택
Atlas 특정 지역 내에서 특정 데이터를 처리한다는 것을 증명해야 하는 경우가 아니라면 범위가 지정되지 않은 모델 API 키를 사용하세요. 범위가 지정되지 않은 키는 ai.mongodb.com 에 대해 작동하고 가장 큰 용량 풀을 사용하며 유료 사용 계층 으로 제한되지 않습니다.
키의 범위를 지리로 지정하기 전에 다음 사항에 유의하세요.
Atlas 범위가 지정된 엔드포인트로 전송하는 토큰에 10% 업리프트를 청구합니다.
범위가 지정된 엔드포인트에는 유료 사용 계층 이 필요합니다. 자세한 학습 은 사용 계층을 참조하세요.
범위가 지정된 엔드포인트에는 자체 속도 제한이 있으며, 이는 범위가 지정되지 않은 엔드포인트보다 낮습니다. 자세한 학습 은 요금 제한 관리를 참조하세요.
키를 생성할 때 지리를 설정하다 하며 이후에는 변경할 수 없습니다. 다른 지리를 사용하려면 새 키를 만듭니다.
조직 특정 지역에서 새 모델 API 키를 생성하도록 요구할 수 있습니다.자세한 학습 은 ManageVoyage AI Model API Keys(Voyage AI 모델 API 키 관리)를 참조하세요.
자세히 알아보기
지리 엔드포인트, 속도 제한, 사용 가능한 모델을 포함하여 지리가 Atlas Embedding and Reranking API 에 AI 적용 학습 , Voyage AI 문서에서 지리를 참조하세요.
Atlas 클러스터에 대해 지원하는 cloud 제공자 및 리전에 대해 학습 클라우드 제공자 및 리전을 참조하세요.