**Geography** とは、ある Atlas サービスに提出されたコンテンツを Atlas が処理するクラウドプロバイダーのリージョンの名前付きグループです。ジオグラフィーは、クラスターがデータを保存するクラウドプロバイダーのリージョンとは独立しています。
世界の特定の地域内で Atlas が特定のデータを処理していることを示す必要がある場合は、地域を使用します。そのような要件がない場合は、地域を選択する必要はありません。
地域とクラスター リージョン
Geography は、クラスターが実行されるクラウドプロバイダーのリージョンと兄弟概念です。2つの境界は独立しており、それぞれを個別に設定します。
リージョンによって、Atlas がクラスターのデータを保存する場所が決定されます。クラスターリージョンは、クラスターをプロビジョニングする際に選択する、
us-west-1やeu-west-2などの単一のクラウドプロバイダーリージョンです。「Geography」は、Atlas が指定されたサービスに提出するコンテンツを処理する場所を管理します。インファレンス ジオグラフィーは、1 つの管轄下にクラウドプロバイダー リージョンをグループ化します。サービスを構成するときにそれを選択しますが、設定するまではスコープ外のままです。
地域を選択してもクラスターは移動しません。また、クラスター リージョンを選択してもプロセシングの範囲が限定されるわけではありません。これら 2 つの設定は独立しているため、Atlas がデータを処理する場所を評価する際には、別々に検討します。
クラスターで利用できるリージョンについて学ぶには、クラウドプロバイダーとリージョンを参照してください。
利用可能な地域
Atlas は以下の地域に対応しています。
地理 | API Value | リージョン | 説明 |
|---|---|---|---|
ヨーロッパ |
| 欧州経済地域 (EEA) | プロセシングは、EEA 域内のクラウドプロバイダーリージョンで実行されます。 |
米国 |
| 米国 | プロセシングは米国内のクラウドプロバイダーリージョンで実行されます。 |
Geography 内のリージョンのセットは、時間の経過とともに変更される可能性があります。地理境界そものは、そうではありません。
指定サービス
指定サービスは、地域スコープに準拠した Atlas サービスです。スコープ指定のリクエストを指定されたサービスに送信すると、Atlas はそのリクエストをジオグラフィ内で処理します。
以下の表には、指定されたサービスと、それぞれのサービスがサポートする地域を示します。
指定サービス | ヨーロッパ | 米国 |
|---|---|---|
Atlas Embedding and Reranking API サービス | はい | はい |
地理的条件内で Atlas 埋め込みと再ランク付けAPIを使用するには、キーを作成するときに、モデルAPIキーをその地理的条件にスコープ設定します。詳細については、 「 AIモデルAPIキーの管理 」を参照してください。
自動埋め込みとネイティブ再ランキングは Atlas でも推論を実行しますが、まだ地域ターゲッティングをサポートしていません。これらのサービスに提出したコンテンツを Atlas が処理する場所を指定することはできません。
地域が保証するもの
地理的範囲に限定されたモデル API キーを使用して指定されたサービスにリクエストを送信すると、以下のコミットメントが適用されます。
Atlas は、お客様がその地域内で提出したコンテンツを処理します。
Atlas がログ記録のために保持するリクエストペイロードは、その Geography 内に保存されます。
Atlas は、すべてのリクエストに、そのリクエストを処理した地理情報 (Geography) を使用してタグを付けます。そのため、地理情報 (Geography) 別に、使用状況レコードと請求書をフィルター処理および監査できます。
ジオグラフィがリクエストを処理できない場合、リクエストは失敗します。Atlas は、リクエストを処理するために別の Geography にフォールバックしません。
スコープされたリクエストは他の場所で実行されるのではなく失敗するため、アプリケーションを設計して、失敗したリクエストをバックオフで再試行し、クライアントに再試行バッジェットを設定するようにします。ユースケースにおいてその地域でのプロセシングが許容できる場合を除き、別の地域のエンドポイントとなる接続されたデバイスへフェイルオーバーしないでください。
地域は Atlas がコンテンツを処理する場所を限定しますが、アカウントは限定しません。アカウントマネジメント、キーマネジメント、リソースポリシー、請求、および使用メタデータは、お客様が選択した地域（Geography）に関わらずグローバルに運用されます。このグローバル メタデータには、プロセシング用に提出するコンテンツは含まれていません。
地域の選択
スコープのないモデル API キーを使用します。ただし、Atlas が世界の特定の地域内で特定のデータを処理することを実証する必要がある場合は除きます。アンスコープキーは ai.mongodb.com に対して使用され、最大のキャパシティープールを利用し、有料使用階層に制限されません。
キーの適用範囲を地理情報に限定する前に、次の点に注意してください。
Atlas は、スコープされたエンドポイントとなる接続されたデバイスに送信するトークンに 10% のアップリフトを課します。
スコープ付きエンドポイントには有料の使用階層が必要です。詳細については、「 使用階層 」を参照してください。
スコープ付きエンドポイントには独自のレート制限があり、この値はスコープが設定されていないエンドポイントよりも低くなります。詳細については、「 レート制限の管理 」を参照してください。
キー作成時に地域を設定します。後から変更することはできません。別の地域を使用するには、新しいキーを作成します。
組織では、特定の地域で新しいモデルAPIキーを作成することを要求できます。詳細については、 「 AIモデルAPIキーの管理 」を参照してください。
詳細
地理的エンドポイント、レート制限、利用可能なモデルなど、 Atlas 埋め込みと再ランク付けAPIに地理的条件が適用される方法については、 投票AIドキュメントの 投票AI推論の地理的条件 を参照してください。
Atlas がクラスターでサポートしているクラウドプロバイダーとリージョンに関する詳細は、「クラウドプロバイダーとリージョン」をご覧ください。