지리는 특정 Atlas 서비스에 제출하는 콘텔츠를 Atlas가 처리하는 클라우드 공급자 리전의 이름이 지정된 그룹입니다. 지리적 영역은 클러스터가 데이터를 저장하는 클라우드 공급자 리전과 독립적입니다.
세계의 특정 지역에서 Atlas가 특정 데이터를 처리하는 것을 표시해야 할 때는 Geography를 사용하세요. 이러한 요구사항이 없는 경우, 지역을 선택할 필요가 없습니다.
지역 및 클러스터 리전
지리적 영역은 클러스터가 실행되는 클라우드 공급자 리전의 형제 개념입니다. 두 개의 경계는 서로 독립적이며, 각각 별도로 설정합니다:
리전은 Atlas가 클러스터의 데이터를 저장하는 곳을 결정합니다. 클러스터 리전은 클러스터를 프로비저닝할 때 선택하는
us-west-1또는eu-west-2등의 단일 클라우드 공급자 리전입니다.**지리**는 Atlas가 지정 서비스에 제출하는 컨텐츠를 처리하는 곳을 제어합니다. inference Geography는 클라우드 공급자 리전을 하나의 관할 아래로 구룹화합니다. 서비스를 구성할 때 이것을 선택합니다. 그리고 설정할 때까지 범위가 지정되지 않은 상태로 유지됩니다.
지역을 선택하더라도 클러스터가 이동하지는 않습니다. 또한 클러스터 리전을 선택하더라도 처리 범위가 제한되지는 않습니다. 이 두 설정은 독립적이므로 Atlas가 데이터를 처리하는 위치를 평가할 때 별도로 검토하십시오.
클러스터에 사용 가능한 리전에 대해 자세히 알아보려면 클라우드 공급자 및 리전을 참조하십시오.
사용 가능한 지역
Atlas는 다음의 지역을 지원합니다.
지리 | API Value | 리전 | 설명 |
|---|---|---|---|
유럽 |
| 유럽 경제 지역(EEA) | 처리는 EEA 내 클라우드 공급자 리전에서 실행됩니다. |
미국 |
| 미국 | 처리는 미국 내의 클라우드 공급자 리전에서 실행됩니다. |
Geography 내의 리전 세트는 시간에 따라 변경될 수 있습니다. 지리 경계 그 자체는 그러지 않습니다.
지정 서비스
지정 서비스는 지리 범위를 준수하는 Atlas 서비스입니다. 지정 서비스에 범위가 지정된 요청을 보내면 Atlas는 지역 내에서 해당 요청을 처리합니다.
다음 표에는 지정 서비스와 각 서비스가 지원하는 지역이 나열됩니다.
지정 서비스 | 유럽 | 미국 |
|---|---|---|
Atlas Embedding and Reranking API 서비스 | 예 | 예 |
지리 내에서 Atlas 임베딩 및 API 재지정을 사용하려면 키를 생성할 때 모델 API 키의 범위를 해당 지리로 지정합니다. 자세한 학습 은 ManageVoyage AI Model API Keys(Voyage AI 모델 API 키 관리)를 참조하세요.
자동 임베딩 및 네이티브 재순위 지정은 Atlas에서 추론도 실행하지만, 아직 지리적 타겟팅을 지원하지 않습니다. Atlas가 이 서비스에 제출하는 내용을 처리할 위치의 범위를 지정할 수 없습니다.
지리가 보장하는 것
지리적 범위가 지정된 모델 API 키를 사용하여 지정된 서비스로 요청을 보낼 때 다음 약정이 적용됩니다.
Atlas가 해당 지역 내에서 제출하는 콘텔츠를 처리합니다.
Atlas가 로그인을 위해 보유하는 요청 페이로드는 해당 지역 내에 저장됩니다.
Atlas는 모든 요청에 요청을 제공한 지역 태그를 지정합니다. 따라서 지역별로 사용 기록과 인보이스를 필터링하고 감사할 수 있습니다.
Geography가 요청을 제공할 수 없으면 요청이 실패합니다. 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가 클러스터용으로 지원하는 클라우드 공급자 및 리전에 대해 알아보려면 클라우드 공급자 및 리전을 참조하세요.