フェデレーティッドデータベースインスタンスの配置

MongoDB Atlas にログインします。

Data Federation左側のナビゲーションで オプションを選択します。

フェデレーティッドデータベースインスタンスを作成します。

1. [ Create New Federated Database ] ドロップダウンをクリックします。

2. Feed Downstream Systems を選択します。

[Get Started] をクリックします。

フィールドにフェデレーティッドデータベースインスタンスの名前を入力し、Federated Database Instance Name Continueをクリックします。

デフォルトはFederatedDatabaseInstance[n]です。 フェデレーティッドデータベースインスタンスは、一度作成されると変更できません。

データソースを指定します。

1. ドロップダウンから、データソースとして使用する Atlas クラスターを選択します。 デフォルトでは、Atlas Data Federation はこのクラスターにすべてのコレクションを追加します。 データのサブセットを使用するには、 Specific Collectionsをクリックし、データベースを展開し、フェデレーティッドデータベースインスタンスに追加するコレクションを選択します。

   Tip

   データベースとコレクションをフィルタリングするには、 Specific Collectionsフィールドにテキストを入力します。 ダイアログ ボックスには、検索条件に一致する名前を持つデータベースとコレクションのみが表示されます。

2. [Continue] をクリックします。

Atlas の AWS IAM ロールを選択します。

ロール選択ドロップダウン リストから、Atlas が認可されている既存のAWS IAM ロールを選択することも、Authorize an AWS IAM Role を選択して新しいロールを認可することもできます。

Atlas が認可する既存のロールを選択した場合は、次のステップに進み、 AWS S3 バケットを一覧表示します。

既存のロールを Atlas に認可するか、新しいロールを作成する場合は、次の手順に進む前に以下の手順を完了してください。

1. ドロップダウンから、 Authorize an AWS IAM Role ] を選択して新しいロールを承認するか、既存のロールを選択します。

2. セクションでAWS ARN Role Authorizationと一意の外部IDを使用して、既存または新規のAWS IAM ロールの信頼関係に Atlas を追加します。

   Atlas UI で、次のいずれかをクリックします。

   • Create new AWS IAM roleは、ARN と一意の外部IDを使用して、新しいAWS IAM ロールの信頼関係に Atlas を追加する方法を示します。 Atlas UIの手順に従って新しいロールを作成します。詳しくは、 「 AWS CLI を使用した新しいロールの作成 」を参照してください。

     新しいロールを認可する際、ワークフローを終了すると次の状況が発生します。

     • ロールを検証する前に、Atlas はフェデレーティッドデータベースインスタンスを作成しません。 AtlasIntegrations ページに移動して新しいロールを認可し、 AWS IAM ロール ARN が付与されたら、フェデレーティッドデータベースインスタンスを再度配置する手順を開始できます。

     • ロールを検証した後、Atlas はフェデレーティッドデータベースインスタンスを作成しません。 ただし、 ロールはロール選択ドロップダウンで使用可能であり、フェデレーティッドデータベースインスタンスの作成に使用できます。 ロールを再度認可する必要はありません。

   • Use existing AWS IAM roleは、ARN と一意の外部IDを使用して、既存のAWS IAM ロールの信頼関係に Atlas を追加する方法を示します。 Atlas UIの手順に従って、Atlas を信頼関係に既存のロールに追加します。詳細については、「 既存のロールへの信頼関係の追加 」を参照してください。

   重要

   将来カスタムAWSロール ARN を変更する場合は、ロールのアクセス ポリシーに、フェデレーティッドデータベースインスタンスの S3 リソースへの適切なアクセスが含まれていることを確認してください。

   詳細については、「統合Amazon Web Servicesアクセスの設定 」および「 クラウドプロバイダー アクセス ロールの作成 」を参照してください。

3. [Validate AWS IAM role] をクリックします。

AmazonAmazon Web Services Web Services IAM ロールにアクセス ポリシーを割り当てます。

1. S3 バケットの名前を入力します。

2. Atlas UI の手順に従って、 Amazon Web Services IAM ロールにアクセス ポリシーを割り当てます。

3. [Validate AWS S3 bucket access] をクリックします。

4. [Continue] をクリックします。

データの抽出をスケジュールします。

セクションの $out を使用して、Atlas クラスターから S3Schedule Queries バケットにデータを継続的にコピーするためのトリガーを予定します。

1. Repeat Once Byドロップダウンを使用して、Atlas クラスターからデータを抽出する頻度を指定します。

2. 任意。 何らかの理由で実行されなかった場合に、Atlas Data Federation が同じクエリを再実行する必要があるかどうかを指定します。 デフォルトでは、これは無効になっており、Atlas Data Federation は見逃したクエリを再実行できます。 あるいは、見逃したクエリに追いつけないようにスキップするには、 をSkip Catch Up Eventsに切り替えます。

3. 任意 。Atlas Data Federation が S3バケットにデータを書き込むときに、データの形式を選択します。Atlas Data Federation は、Parquet、CSV、BSON、およびMongoDB拡張JSONをサポートしています。

4. Max File SizeAtlas Data Federation が S3 バケットに書き込む各ファイルのサイズを制限するには、 を指定します。例、Max File Size を100 MB に設定し、クエリが1 GBのデータを返す場合、Atlas Data Federation はクエリを S3 バケットに書込みます（10 100ファイルごと）。

5. 宛先 S バケットのAWSプレフィックスを入力します。3

6. Date Fieldのインデックス付き日付フィールドの名前を入力し、 ドロップダウンを使用してその値の形式を指定します。 下流にコピーするすべてのコレクションには、タイムスタンプを値として保存するインデックス付きフィールドが必要です。

7. [Continue] をクリックします。

[Create] をクリックします。

MongoDB Atlas にログインします。

Data Federation左側のナビゲーションで オプションを選択します。

フェデレーティッドデータベースインスタンスを作成します。

1. [ Create New Federated Database ] ドロップダウンをクリックします。

2. Explore with Sample Data を選択します。

[Get Started] をクリックします。

[Create] をクリックします。

MongoDB Atlas にログインします。

Data Federation左側のナビゲーションで オプションを選択します。

フェデレーティッドデータベースインスタンスを作成します。

1. [ Create New Federated Database ] ドロップダウンをクリックします。

2. Query Data Across Clusters を選択します。

[Get Started] をクリックします。

フィールドにフェデレーティッドデータベースインスタンスの名前を入力し、Federated Database Instance Name Continueをクリックします。

デフォルトはFederatedDatabaseInstance[n]です。 フェデレーティッドデータベースインスタンスは、一度作成されると変更できません。

データソースとして使用する Atlas クラスターを指定します。

1. ドロップダウンから、データソースとして使用する Atlas クラスターを選択します。 Atlas は、このドロップダウンに現在の Atlas プロジェクト内のクラスターのみを表示します。

2. データベースを展開し、フェデレーティッドデータベースインスタンスに追加するコレクションを選択します。

   Tip

   データベースとコレクションをフィルタリングするには、 Specific collectionsフィールドにテキストを入力します。 ダイアログ ボックスには、検索条件に一致する名前を持つデータベースとコレクションのみが表示されます。

3. 任意。 Cluster Read Preference設定を展開して、次のフィールドを構成します。

   フィールド名	説明
   Read Preference Mode	読み取りリクエストをルーティングするレプリカセット ノードを指定します。 ドロップダウンから、次のいずれかを選択できます。 primary - すべての読み取りリクエストをレプリカセットのプライマリにルーティングします primaryPreferred - primaryが使用できない場合にのみ、すべての読み取りリクエストをレプリカセットのプライマリとセカンダリノードにルーティングします secondary - すべての読み取りリクエストをレプリカセットのセカンダリノードにルーティングします secondaryPreferred - secondaryノードが使用できない場合にのみ、すべての読み取りリクエストをレプリカセットのセカンダリノードとシャーディングされたクラスター上のプライマリにルーティングします nearest - メンバーがプライマリであるか、セカンダリであるかに関係なく、すべての読み取りリクエストを、ランダムに選択された適格なレプリカセット メンバーにルーティングします。 Atlas クラスターをストアとして追加する場合、デフォルト値はsecondaryです。 フェデレーティッドデータベースインスタンスのストレージ構成で何も設定しない場合、デフォルト値はnearestです。 詳しくは、「読み込み設定（read preference）モード 」を参照してください。 重要: Data Federationとプライマリ ノードへの影響 Data Federation クエリが、セカンダリ ノードを対象とする読み込み設定 (read preference)で構成されている場合、バッキング Atlas クラスターのプライマリに負荷を生成することは予想されません。セカンダリ で開始されたクエリは、そのノードへのカーソルのアフィニティを維持します。 一部のログでは、getMore 操作が primaryPreferred の読み込み設定 (read preference)に表示される場合があります。これは期待される動作であり、カーソルがプライマリに切り替えられたことを示すものではありません。primaryPreferredモードはプライマリ ノードとセカンダリ ノードの両方で有効であり、クエリを再発行することなく、まれなロールの変更（セカンダリがプライマリになるなど）を取り扱うことができます。カーソルの実行は、ノード自体のロールが変更されない限り、元のノードで続行されます。 Data Federation は、追加の構成なしでワークロードを プライマリ から分離します。primaryPreferredモードを使用すると、プライマリ ノードとセカンダリ ノードの両方との互換性が確保され、クエリを再発行することなく、セカンダリがプライマリになるなど、まれなロールの変更を処理できます。カーソルの実行は、ノード自体のロールが変更されない限り、元のノードで続行されます。
   TagSets	読み取りリクエストをルーティングするレプリカセット ノードの、名前と値のペアを含むタグまたはタグ仕様ドキュメントのリストを指定します。 詳しくは、「読み込み設定（read preference）タグセット 」を参照してください。
   Maxstaleness Seconds	セカンダリからの読み取りの最大レプリケーションラグ、つまり「古さ」を指定します。 詳細については、「読み込み設定（read preference） maxStalenessSeconds 」を参照してください。

4. Add Atlas cluster and collectionをクリックし、データソースとして使用するすべての Atlas クラスターに対してこれらの手順を繰り返します。

5. クラスターの追加が完了したら、[ Continue ] をクリックします。

[Create] をクリックします。