地理的とは、特定の Atlas サービスに送信したコンテンツを Atlas が処理するクラウドプロバイダーリージョンのグループです。地理的は、クラスターがデータを保存するクラウドプロバイダーのリージョンとは独立しています。
Atlas が世界の特定の部分内の特定のデータを処理していることを示す必要がある場合は、 地理を使用します 。そのような要件がない場合は、「 地理 」を選択する必要はありません。
注意
パブリック プレビュー
ヨーロッパ 地理はパブリック プレビュー機能として利用できます。機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。
地理とクラスター リージョン
地理的とは、クラスターが実行されるクラウドプロバイダーのリージョンの兄弟概念です。 2 つの境界は独立しており、それぞれを個別に設定します。
リージョンは、Atlas がクラスターのデータを保存する場所を管理します。クラスター リージョンは、クラスターをプロビジョニングするときに選択する単一のクラウドプロバイダーリージョン（ や
us-west-1eu-west-2など）です。地理的情報は、指定サービスに送信したコンテンツを Atlas が処理する場所を管理します。推論 地理は 1 つの権限の下にクラウドプロバイダーリージョンをグループ化します。サービスを設定するときに選択しますが、設定するまでスコープは設定されません。
地理を選択してもクラスターは移動されず、クラスター リージョンを選択しても処理のスコープは変更されません。これら 2 つの設定は独立しているため、Atlas がデータを処理する場所を評価するときに個別に確認してください。
利用可能な地域
Atlas は次の地理をサポートしています。
地理 | API Value | リージョン | 説明 |
|---|---|---|---|
ヨーロッパ |
| 欧州経済領域（ EEA） | プロセシングは EEA 内のクラウドプロバイダーリージョンで実行されます。 |
米国 |
| 米国 | プロセシングは、米国内のクラウドプロバイダーリージョンで実行されます。 |
地理的内のリージョンのセットは、時間の経過とともに変化する可能性があります。地理的境界自体はありません。
指定サービス
指定サービスは、 地理的スコープ を尊重する Atlas サービスです。指定サービスにスコープ指定されたリクエストを送信すると、Atlas は Geograph 内のリクエストを処理します。
次の表は、それぞれがサポートする指定サービスと地理を示しています。
指定サービス | ヨーロッパ | 米国 |
|---|---|---|
Atlas 埋め込みと再ランク付けAPIサービス | はい | はい |
地理的条件内で Atlas 埋め込みと再ランク付けAPIを使用するには、キーを作成するときに、モデルAPIキーをその地理的条件にスコープ設定します。詳細については、「 モデルAPIキー 」を参照してください。
自動埋め込み と ネイティブ再ランク付け も Atlas では推論を実行しますが、地理的ターゲティングはまだサポートされていません。これらのサービスに送信したコンテンツを Atlas が処理する範囲は指定できません。
地理が保証すること
地理にスコープが設定されたモデルAPIキーを使用して、指定サービスにリクエストを送信すると、次のコミットメントが保持されます。
Atlas は、その Geograph 内で送信したコンテンツを処理します。
Atlas がログ用に保持するリクエスト ペイロードは、Geograph 内に保存されます。
Atlas はすべてのリクエストを提供した地理的情報にタグを付けるため、使用状況レコードと請求書を地理的別にフィルタリングして監査するできます。
地理がリクエストを処理できない場合、リクエストは失敗します。 Atlas は、リクエストを処理するために別の地理的配置に戻ることはありません。
スコープ指定されたリクエストは別の場所で実行中のではなく失敗するため、バックオフで失敗したリクエストを再試行し、クライアントの再試行予算を設定する ようにアプリケーションを設計します。ユースユースケースで処理が受け入れられる場合を除き、別の地理のエンドポイントにフェイルオーバーしないでください。
地理的制約により、Atlas が アカウントではなくコンテンツを処理する場所が制限されます。アカウント管理、キー管理、リソースポリシー、請求、使用状況メタデータは、選択した地域に関係なくグローバルに動作します。このグローバルメタデータには、処理対象として送信したコンテンツは含まれません。
地域の選択
Atlas が世界の特定の部分内の特定のデータを処理することを証明する必要がある場合を除き、スコープが設定されていないモデルAPIキーを使用します。スコープが設定されていないキーは ai.mongodb.com に対して機能し、最大のキャパシティープールで使用され、有料使用量の階層に制限されません。
キーを 地域 にスコープ設定する前に、次の点に注意してください。
Atlas は、スコープ指定されたエンドポイントに送信するトークンに対して 10% の回収漏れ費用を請求します。
スコープ付きエンドポイントには有料の使用階層が必要です。詳細については、「 使用階層 」を参照してください。
スコープ付きエンドポイントには独自のレート制限があり、この値はスコープが設定されていないエンドポイントよりも低くなります。詳細については、「 レート制限の管理 」を参照してください。
キーを作成するときに「地理」を設定しますが、その後はそれを変更できません。別の地理を使用するには、新しいキーを作成します。
組織では、特定の地域で新しいモデルAPIキーを作成することを要求できます。詳細については、「 モデルAPIキー 」を参照してください。
詳細
地理的エンドポイント、レート制限、利用可能なモデルなど、 Atlas 埋め込みと再ランク付けAPIに地理的条件が適用される方法については、 投票AIドキュメントの 投票AI推論の地理的条件 を参照してください。
Atlas がクラスターでサポートするクラウドプロバイダーとリージョンの詳細については、「 クラウドプロバイダーとリージョン 」を参照してください。