Docs Menu
Docs Home
/
MongoDB Atlas
/ /

Atlas Online Archive の管理

項目一覧

  • 必要なアクセス権
  • オンライン アーカイブの表示
  • Atlas CLI を使用した Atlas Online Archive の取得
  • API を使用して Atlas Online Archive を取得する
  • API を使用してクラスターのすべてのオンライン アーカイブを取得
  • UI でのオンライン アーカイブの表示
  • Atlas Online Archive メトリクスの表示
  • Atlasで、プロジェクトのフェデレーティッドデータベースインスタンスにGoします。
  • メトリクスを確認します。
  • アーカイブ ルールの編集
  • Atlas CLI を使用したアーカイブ ルールの編集
  • API を使用してアーカイブ ルールを編集
  • UI を通じてアーカイブ ルールを編集
  • クラウド オブジェクト ストアでのパーティションの編集
  • クエリ Atlas Online Archive
  • 接続文字列
  • パフォーマンスに関する考慮事項
  • クエリの価格
  • Atlas Online Archive の削除
  • Atlas CLI を使用した Atlas Online Archive の削除
  • UI からの Atlas Online Archive の削除
  • API を介した Atlas Online Archive の削除

重要

サーバーレスインスタンスで使用できない機能

サーバーレスインスタンスは現時点ではこの機能をサポートしていません。詳細については、 サーバーレスインスタンスの制限を参照してください。

オンライン アーカイブを構成した後、次の操作を実行できます。

  • Atlas Online Archive の表示

  • Atlas Online Archive の編集

  • オンライン アーカイブのクエリ

  • オンライン アーカイブの削除

オンライン アーカイブを表示またはクエリするには、プロジェクトに対する Project Read Only以上のアクセス権が必要です。

オンライン アーカイブを編集または削除するには、プロジェクトに対するProject Data Access Admin以上のアクセス権が必要です。

重要

サーバーレスインスタンスで使用できない機能

サーバーレスインスタンスは現時点ではこの機能をサポートしていません。詳細については、「サーバーレスインスタンスの制限」を参照してください。

Atlas CLI、Atlas UI、 APIを使用して、クラスターのオンライン アーカイブの一覧を表示できます。

Atlas CLI を使用してクラスターのすべてのオンライン アーカイブを一覧表示するには、次のコマンドを実行します。

atlas clusters onlineArchives list [options]

Atlas CLI を使用して指定したオンライン アーカイブの詳細を返すには、次のコマンドを実行します。

atlas clusters onlineArchives describe <archiveId> [options]

前のコマンドの構文とパラメーターの詳細について詳しくは、Atlas CLI ドキュメントの Atlas clusters onlineArchives list および Atlas clusters onlineArchives describe を参照してください。

Tip

参照: 関連リンク

API経由でオンライン アーカイブを検索するには、検索対象のオンライン アーカイブの一意の ID を指定して、 OnlineAr ArchivesエンドポイントにGETリクエストを送信します。 API構文とオプションの詳細については、「 API 」を参照してください。

APIを使用してクラスターに構成されたすべてのオンライン アーカイブを取得するには、クラスターのOnlineAr ArchivesエンドポイントにGETリクエストを送信します。 構文とオプションの詳細については、「 API 」を参照してください。

Atlas Online Archive の一覧を表示するには:

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。

    [ Clusters (クラスター) ] ページが表示されます。

2
  1. クラスターの名前をクリックします。

  2. [Online Archive] タブをクリックします。

    Atlas Online Archiveページが表示されます。

ページには、クラスターのオンライン アーカイブが表示されます。 各オンライン アーカイブについて、次の情報を表示できます。

注意

年 6 月 日のリリースで利用可能な新しいメトリクスの値は、 7 Date Match 2023のリリース後に作成されたオンライン アーカイブの Atlas UI にのみ表示されます。 時系列 Online Archive を作成する場合、またはリリース日後に既存のオンライン アーカイブが存在する場合、Atlas はメトリクス値の代わりにN/Aを表示します。

列名
説明
Status

オンライン アーカイブのステータス。 値は次のいずれかになります。

支払い待ち
ドキュメントがアーカイブのキューに入れられているが、アーカイブはまだ開始されていないことを示します。
アーカイブ
アーカイブが開始されたことを示します。 この状態では、アーカイブの基準を満たすドキュメントがアーカイブされます。
アイドル
オンライン アーカイブが次のアーカイブジョブの開始を待機していることを示します。
一時停止
アーカイブの一時停止をリクエストしたことを示します。 この状態では、Atlas は実行中のアーカイブ操作を参照しているため、Atlas はアーカイブをまだ保持していません。 実行中のアーカイブ操作が完了すると、オンライン アーカイブはPaused状態に移行します。
paused
アーカイブが一時的に停止されたことを示します。 この状態では、以前にアーカイブされたドキュメントは引き続きクエリ用にクラウド オブジェクト ストレージで利用できますが、アクティブなクラスターで指定されたアーカイブ操作は保留され、追加のドキュメントはアーカイブされません。 You can resume archiving for paused archives at any time.
孤立
アクティブまたは一時停止中のオンライン アーカイブに関連付けられているコレクションが削除されたことを示します。 Atlas はアーカイブ データを自動的に削除しません。 削除されたコレクションに関連付けられているオンライン アーカイブは、手動で削除する必要があります。
削除
オンライン アーカイブが削除されたことを示します。 オンライン アーカイブを削除すると、関連付けられているアーカイブ ドキュメントがクラウド オブジェクト ストレージから削除されます。
Actions
Online Archiveで実行できる操作。
Archive Field
アーカイブされたドキュメントに基づく日付フィールド。
Custom Criteria
カスタムJSONフィルター。 このコード コンポーネントではスクロールが可能です。 [] アイコンをクリックしてビューを展開し、完全なカスタム条件を表示します。
Age Limit
アーカイブのドキュメントを資格化するために使用される日数。
Deletion Age Limit
アーカイブ内のデータを削除する日数。
Total Data Archived
アーカイブに保存される非圧縮データ サイズ。 アーカイブ内のドキュメント数を表示するには、 をカーソルします。 新しいオンラインアーカイブでのみ使用可能なメトリクス。
Last Archived Run
アーカイブが最後に実行されたとき、開始日付とタイムスタンプ。 カーソルを合わせると、最後の 5 つのジョブが表示されます。 各ジョブは、開始日、開始時間、アーカイブ期間、ドキュメント数、サイズとともに表示されます。
Partition Fields
クラウド オブジェクト ストレージ上のデータをパーティション分割するために使用されるその他の一般的に使用されるクエリ フィールド。
Schedule
アーカイブ ウィンドウ ケイデンス。 値は次のとおりです: - Monthy on <Day_Number> - Weekly on <Day_Name> - Dailyカーソルを合わせると、次のアーカイブ ウィンドウが表示されます。
Min Date Field
アーカイブ内のすべてのドキュメントの最小日付値。 Metric available only for new Online Archives on Atlas Data Federation.
Max Date Field
アーカイブ内のすべてのドキュメントの最大日付値。 Atlas Data Federation の新しい Online Archive でのみ利用可能なメトリクス。

Atlas UI で Atlas Online Archive のメトリクスを表示するには:

1
  1. まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。

  3. サイドバーで、 Services見出しの下のData Federationをクリックします。

    Data Federationページが表示されます。

2

ページでは、 Online Archive Federated Database Instancesセクションの下に各フェデレーティッドデータベースインスタンスについて次のメトリクスが表示されます。

実行されるクエリの実行数 / 月
現在の暦月で実行されたクエリの数(累計)。 Atlas はこの値を 5 分ごとに更新します。
データ処理 / 月
現在の暦月で処理されるデータの量。 Atlas はこの値を 5 分ごとに更新します。
返されたデータ / 月
現在の暦月に返されたデータの量。 Atlas はこの値を 5 分ごとに更新します。
前回のアーカイブ実行
Atlas がアーカイブ ジョブを最後に実行してデータをアーカイブした日時。

重要

サーバーレスインスタンスで使用できない機能

サーバーレスインスタンスは現時点ではこの機能をサポートしていません。詳細については、「サーバーレスインスタンスの制限」を参照してください。

Atlas クラスター( Age Limit )またはアーカイブ用ドキュメントの選択に使用されるカスタムJSONクエリにデータを保持する日数は、 Atlas UI とAPIから変更できます。 アーカイブ基準は、 Date MatchからCustom Filterへ、またはその逆方向へ変更することはできません。

Atlas CLI を使用してクラスターのオンライン アーカイブを更新するには、次のコマンドを実行します。

atlas clusters onlineArchives update <archiveId> [options]

コマンド構文とパラメータについて詳しくは、Atlas CLI Atlasclusters onlineArchives update の ドキュメントを参照してください。

APIを通じてオンライン アーカイブを編集するには、アップデートするオンライン アーカイブの一意の ID を指定して、 OnlineAr ArchivesエンドポイントにPATCHリクエストを送信します。 API構文とオプションの詳細については、「 API 」を参照してください。

Atlas UI でオンライン アーカイブを編集するには、以下の手順に従います。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。

    [ Clusters (クラスター) ] ページが表示されます。

2
  1. クラスターの名前をクリックします。

  2. [Online Archive] タブをクリックします。

    Atlas Online Archiveページが表示されます。

3

オンライン アーカイブのActions列の省略記号( ... )をクリックすると、許可されたアクションのリストが表示されます。 ここでは、次の作業が可能です。

  • Pause Archiving (状態がActiveの場合のみ)

  • Edit Archive

  • Delete Archive

  • Resume Archiving (状態がPausedの場合のみ)

4

アーカイブ データを削除するアーカイブ基準と日数を変更できます。

  • Date Match基準を編集するには、 Archival Age Limitセクションのアクティブな Atlas クラスターに Atlas がデータを保存する日数を変更します。

  • Custom Criteriaを編集するには、有効なJSONフィルターを入力して、アーカイブするドキュメントを選択します。

    注意

    Atlas は、指定されたクエリをdb.collection.find(query)で使用します。 コマンドを使用します。 カスタム クエリは JavaScript 式をサポートしていません。 また、空のドキュメント{}を渡してすべてのドキュメントを返すことはできません。

  • Atlas がアーカイブ データを削除する日数を変更するには、 Deletion Age Limitセクションに日数を入力または変更します。 7から9125日の間で指定するか、 フィールドを空のままにしてデータ有効期限ルールを無効にすることができます。 この変更が有効になるまでには 24 時間かかります。

  • データ アーカイブ ジョブのスケジュールされた時間を変更するには、次のいずれかを変更します。

    • 頻度。 ジョブは毎日、特定の日に実行するか、毎月特定の日付に実行するかを選択できます。 毎月 29 日、30 日、または 31 日にアーカイブする場合、それらのAtlasを含まない月のアーカイブ ジョブは実行されません。

    • 時間枠。 Atlas がデータ アーカイブ ジョブを実行する期間を選択します。 少なくとも 2 時間を指定する必要があります。

    また、 Schedule Archive Windowを切り替えてスケジュールを無効にすることもできます。 スケジュールを無効にすると、Atlas はデフォルトのスケジュールに戻り、アーカイブ ジョブを定期的に実行します。

    Atlas は、変更後すぐに新しいデータ アーカイブ スケジュールの使用を開始します。 ただし、アーカイブ ジョブが現在実行中の場合、Atlas は実行中のジョブを中断することはなく、ジョブが完了した後に設定が有効になります。

5

注意

Deletion Age Limitへの変更が有効になるまでに 24 時間かかります。

Atlas UI またはAPIからパーティション フィールドまたは構造を変更することはできません。 ただし、 $mergeを使用してクラウド オブジェクト ストレージからデータを手動で移行した後、 $mergeを使用して Atlas クラスターにデータを再ハイライトし、オンライン アーカイブを削除してから、必要なパーティション フィールドを含むコレクション用の新しいオンライン アーカイブを作成します。および 構造。

アーカイブされたデータに対してクエリを実行できます。

注意

Atlas Data Federation は、ドキュメント内のフィールドの順序を保持しない列指向ストレージを使用します。 したがって、Atlas Data Federation は、アーカイブ データの機密性が高いデータに対してフィールド順序を持つクエリをサポートしていません。

クエリを実行するには、まずAtlas Online Archive に接続する必要があります。 クラスター接続文字列では、 Atlasクラスター内のデータのみをクエリできます。 Atlas Online Archive をクエリするには、次のいずれかを使用する必要があります。

  • Atlas Online Archive とクラスターへの接続- この読み取り専用接続文字列では、本番環境クラスターから直接データを読み取ることができます。 これは、 IOPSと Atlas Online Archive の利用可能なリソースに影響します。

  • Online Archive への接続- この読み取り専用接続文字列では、Online Archive からのみデータを読み取ることができ、クラスター リソースには影響しません。

一般に、アーカイブ データに対するクエリは、Atlas クラスター上のデータに対するクエリよりもはるかに遅くなります。 フェデレーティッド接続文字列を介してクラスターとオンラインアーカイブ内のデータをクエリする場合:

  • 結果を返す前にすべての入力ドキュメントを消費してソート操作に処理するソートなどのブロッキングクエリは、クエリされる最も遅いストレージであるアーカイブに関連付けられたパフォーマンス特性があります。 ソート操作では、結果を返す前にソースからのすべてのデータがクエリされている必要があります。

  • 検索などのストリーミング クエリには、クエリ対象の最もパフォーマンスが高いストレージである Atlas クラスターに関連するパフォーマンス特性があります。 Atlas は利用可能になるとすぐに結果を返すため、 アーカイブから結果を返すには、Atlas クラスターから結果を返すよりも時間がかかります。

フェデレーティッド クエリとアーカイブ専用クエリでは、次の項目のコストが発生します。

データスキャン中に、Atlas はクラスターとアーカイブの両方のデータを処理します。 Atlas は、スキャンが必要なデータ量を最小限に抑えるために、クラスターに対して可能な限り多くのクエリを実行します。 たとえば、特定の値を指定するmatchクエリの場合、Atlas は指定された値を持つドキュメントのみをクラスターから検索します。 次に、Atlas は取得されたドキュメントをアーカイブされたデータと結合して返します。

基礎のクラスターに保存されているすべてのデータにアクセスする必要があるブロック クエリの場合、Atlas はすべてのデータを検索します。 たとえば、 sortmatchがない場合)の場合、Atlas はクラスターとアーカイブから並べ替え対象のすべてのデータを検索します。

MongoDB は、アーカイブ内のクエリを実行するパーティションごとに料金を請求します。 クエリで特定のパーティションのクエリが必要な場合、MongoDB はパーティションをダウンロードし、ダウンロードされた各パーティションは 1 回のアクセスに対応します。

クエリ フィールドと クエリ フィールドに基づいてパーティションを検索するために、Atlas はアーカイブに対して操作を実行します。 Atlas が実行するこのような操作ごとに、最大 1000 個のパーティションが検索されます。 Atlas は、クエリを満たすために必要なパーティションを見つけるために、必要な最小数の操作を実行します。 たとえば、クエリに、クエリ フィールドでカバーされる 100 個のパーティションが必要な場合、Atlas はクエリを満たすために 1 回の操作のみを実行します。

フェデレーティッド インフラストラクチャに転送されるデータには、データ転送コストが発生します。

重要

サーバーレスインスタンスで使用できない機能

サーバーレスインスタンスは現時点ではこの機能をサポートしていません。詳細については、「サーバーレスインスタンスの制限」を参照してください。

Atlas CLI、Atlas UI、 APIを使用してオンライン アーカイブを削除できます。 オンライン アーカイブを削除すると、Atlas はオンライン アーカイブ ストレージ上のすべてのファイルとメタデータを 5 日後に削除します。 このデータを削除すると、復元することはできません。

オンライン アーカイブ用に構成されたデータベースまたはコレクションを削除した場合でも、コレクションのデータがアーカイブされている場合は、クラウド オブジェクト ストレージで引き続き利用できます。 クラウド オブジェクト ストレージでのストレージ使用コストが発生します。 あるいは、クラスターを削除すると、Atlas はそのクラスターに設定されたすべてのオンライン アーカイブを削除します。 これにより、クラウド オブジェクト ストレージからアーカイブ データも削除されます。

オンライン アーカイブをすべて削除すると、フェデレーティッドデータベースインスタンスも削除され、オンライン アーカイブを再度作成すると、新しいフェデレーティッドデータベースインスタンスが作成されます。

オンライン アーカイブを削除すると、その状態はDeletedに移行します。 Active状態のデータベース、コレクション、フィールドを対象とするオンライン アーカイブが存在しない場合は、削除したオンライン アーカイブと同じデータベース、コレクション、フィールド用に別のオンライン アーカイブを作成できます。

Atlas CLI を使用してクラスターのオンライン アーカイブを削除するには、次のコマンドを実行します。

atlas clusters onlineArchives delete <archiveId> [options]

コマンド構文とパラメータについて詳しくは、Atlas CLI Atlasclusters onlineArchives delete の ドキュメントを参照してください。

Atlas UI でオンライン アーカイブを削除するには、以下の手順に従います。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。

    [ Clusters (クラスター) ] ページが表示されます。

2
  1. クラスターの名前をクリックします。

  2. [Online Archive] タブをクリックします。

    Atlas Online Archiveページが表示されます。

3

オンライン アーカイブのActions列の省略記号( ... )をクリックすると、許可されたアクションのリストが表示されます。 ここでは、次の作業が可能です。

  • Pause Archiving (状態がActiveの場合のみ)

  • Edit Archive

  • Delete Archive

  • Resume Archiving (状態がPausedの場合のみ)

4
5

APIを通じてオンライン アーカイブを削除するには、削除するオンライン アーカイブの一意の ID を指定して、 OnlineAr ArchivesエンドポイントにDELETEリクエストを送信します。 構文とオプションの詳細については、「 API 」を参照してください。

戻る

Atlas Online Archive への接続