Atlas で オンライン アーカイブ を管理する

Atlas CLI を使用した Atlas Online Archive の取得

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 を参照してください。

API を使用して Atlas Online Archive を取得する

To retrieve an online archive through the API, send a GET request to the onlineArchives endpoint with the unique ID of the online archive to retrieve. To learn more about the API syntax and options, see API.

API を使用してクラスターのすべてのオンライン アーカイブを取得

To retrieve all the online archives configured for a cluster using the API, send a GET request to the onlineArchives endpoint for the cluster. To learn more about the syntax and options, see API.

UI でのオンライン アーカイブの表示

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

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

Atlas CLI を使用したアーカイブ ルールの編集

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

atlas clusters onlineArchives update <archiveId> [options]

To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas clusters onlineArchives update.

API を使用してアーカイブ ルールを編集

To edit an online archive through the API, send a PATCH request to the onlineArchives endpoint with the unique ID of the online archive to update. To learn more about the API syntax and options, see API.

UI を通じてアーカイブ ルールを編集

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

クラウド オブジェクト ストアでのパーティションの編集

You can't modify the partition fields or structure from the Atlas UI or API. However, you can manually migrate the data from the cloud object storage using $merge, use $merge to rehydrate data back to Atlas cluster, delete the online archive, and then create a new online archive for the collection with the desired partition fields and structure.

接続文字列

To run queries, you must first connect to your Online Archive. Your cluster connection string allows you to only query data in your Atlas cluster. To query your Online Archive, you must use one of the following:

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

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

パフォーマンスに関する考慮事項

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

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

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

クエリの価格

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

Atlas CLI を使用した Atlas Online Archive の削除

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

atlas clusters onlineArchives delete <archiveId> [options]

To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas clusters onlineArchives delete.

UI からの Atlas Online Archive の削除

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

API を介した Atlas Online Archive の削除

To delete an online archive through the API, send a DELETE request to the onlineArchives endpoint with the unique ID of the online archive to delete. To learn more about the syntax and options, see API.

アーカイブ用にマークされた時系列バケットを除く

When Online Archive archives a time series collection, it first sets the internal control.closed field to true on each bucket that it marks for archival. After this field is set, the time series collection doesn't allow writes to the bucket. Inserts that would target the bucket write to another bucket or open a new one. Updates and deletes through the time series collection ignore the bucket.

オンラインアーカイブがこれらのバケットをクラスターから除く前にオンラインアーカイブを削除すると、バケットはクラスターに残ります。時系列コレクションに対する削除する操作は、これらのバケットに含まれるドキュメントに対して0のdeletedCountを返します。

To remove these buckets, run a delete operation directly against the buckets. To run this operation, your database user must have the readWriteAnyDatabase role. The method depends on your MongoDB version:

• 8.2より前のMongoDBバージョンの場合、system.buckets.<collection>コレクションで削除する操作を実行します。

• For MongoDB 8.2 and later, run the delete command on the time series collection with the rawData: true option.

const cutoff = ISODate("2026-03-01T00:00:00Z");
db.getSiblingDB("<database>")
  .getCollection("system.buckets.<collection>")
  .find({
    "control.closed": true,
    "control.max.<timeField>": { $lte: cutoff }
  })
  .itcount()

const cutoff = ISODate("2026-03-01T00:00:00Z");
db.getSiblingDB("<database>")
  .getCollection("system.buckets.<collection>")
  .deleteMany({
    "control.closed": true,
    "control.max.<timeField>": { $lte: cutoff }
  })

const cutoff = ISODate("2026-03-01T00:00:00Z");
db.getSiblingDB("<database>").runCommand({
  delete: "<collection>",
  deletes: [
    {
      q: {
        "control.closed": true,
        "control.max.<timeField>": { $lte: cutoff }
      },
      limit: 0
    }
  ],
  rawData: true
})