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 の削除
オンライン アーカイブを構成した後、次の操作を実行できます。
必要なアクセス権
オンライン アーカイブを表示またはクエリするには、プロジェクトに対する Project Read Only
以上のアクセス権が必要です。
オンライン アーカイブを編集または削除するには、プロジェクトに対するProject Data Access Admin
以上のアクセス権が必要です。
オンライン アーカイブの表示
Atlas CLI、Atlas UI、 APIを使用して、クラスターのオンライン アーカイブの一覧を表示できます。
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 を取得する
API経由でオンライン アーカイブを検索するには、検索対象のオンライン アーカイブの一意の ID を指定して、 OnlineAr ArchivesエンドポイントにGET
リクエストを送信します。 API構文とオプションの詳細については、「 API 」を参照してください。
API を使用してクラスターのすべてのオンライン アーカイブを取得
APIを使用してクラスターに構成されたすべてのオンライン アーカイブを取得するには、クラスターのOnlineAr ArchivesエンドポイントにGET
リクエストを送信します。 構文とオプションの詳細については、「 API 」を参照してください。
UI でのオンライン アーカイブの表示
Atlas Online Archive の一覧を表示するには:
AtlasClusters で、プロジェクトの ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [ Clusters ] をクリックします。
[ Clusters (クラスター) ] ページが表示されます。
Online Archiveクラスターの ページにGoします。
クラスターの名前をクリックします。
[Online Archive] タブをクリックします。
Atlas Online Archiveページが表示されます。
ページには、クラスターのオンライン アーカイブが表示されます。 各オンライン アーカイブについて、次の情報を表示できます。
注意
年 6 月 日のリリースで利用可能な新しいメトリクスの値は、 7 Date Match 2023のリリース後に作成されたオンライン アーカイブの Atlas UI にのみ表示されます。 時系列 Online Archive を作成する場合、またはリリース日後に既存のオンライン アーカイブが存在する場合、Atlas はメトリクス値の代わりにN/A
を表示します。
列名 | 説明 | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | オンライン アーカイブのステータス。 値は次のいずれかになります。
| ||||||||||||||
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 Online Archive メトリクスの表示
Atlas UI で Atlas Online Archive のメトリクスを表示するには:
Atlasで、プロジェクトのフェデレーティッドデータベースインスタンスにGoします。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Services見出しの下のData Federationをクリックします。
Data Federationページが表示されます。
アーカイブ ルールの編集
Atlas クラスター( Age Limit )またはアーカイブ用ドキュメントの選択に使用されるカスタムJSONクエリにデータを保持する日数は、 Atlas UI とAPIから変更できます。 アーカイブ基準は、 Date MatchからCustom Filterへ、またはその逆方向へ変更することはできません。
Atlas CLI を使用したアーカイブ ルールの編集
Atlas CLI を使用してクラスターのオンライン アーカイブを更新するには、次のコマンドを実行します。
atlas clusters onlineArchives update <archiveId> [options]
コマンド構文とパラメータについて詳しくは、Atlas CLI Atlasclusters onlineArchives update の ドキュメントを参照してください。
API を使用してアーカイブ ルールを編集
APIを通じてオンライン アーカイブを編集するには、アップデートするオンライン アーカイブの一意の ID を指定して、 OnlineAr ArchivesエンドポイントにPATCH
リクエストを送信します。 API構文とオプションの詳細については、「 API 」を参照してください。
UI を通じてアーカイブ ルールを編集
Atlas UI でオンライン アーカイブを編集するには、以下の手順に従います。
AtlasClusters で、プロジェクトの ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [ Clusters ] をクリックします。
[ Clusters (クラスター) ] ページが表示されます。
Online Archiveクラスターの ページにGoします。
クラスターの名前をクリックします。
[Online Archive] タブをクリックします。
Atlas Online Archiveページが表示されます。
オンライン アーカイブのActions列の省略記号( ...
)をクリックすると、許可されたアクションのリストが表示されます。 ここでは、次の作業が可能です。
Pause Archiving (状態がActiveの場合のみ)
Edit Archive
Delete Archive
Resume Archiving (状態がPausedの場合のみ)
Edit Archiveドロップダウンから を選択して、アーカイブ ルール、アーカイブ データを保持する日数、データ アーカイブ ジョブの実行中時間ウィンドウを変更します。
アーカイブ データを削除するアーカイブ基準と日数を変更できます。
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 は実行中のジョブを中断することはなく、ジョブが完了した後に設定が有効になります。
クラウド オブジェクト ストアでのパーティションの編集
Atlas UI またはAPIからパーティション フィールドまたは構造を変更することはできません。 ただし、 $merge
を使用してクラウド オブジェクト ストレージからデータを手動で移行した後、 $merge
を使用して Atlas クラスターにデータを再ハイライトし、オンライン アーカイブを削除してから、必要なパーティション フィールドを含むコレクション用の新しいオンライン アーカイブを作成します。および 構造。
クエリ Atlas Online Archive
アーカイブされたデータに対してクエリを実行できます。
注意
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 はすべてのデータを検索します。 たとえば、 sort
( match
がない場合)の場合、Atlas はクラスターとアーカイブから並べ替え対象のすべてのデータを検索します。
データアクセス
MongoDB は、アーカイブ内のクエリを実行するパーティションごとに料金を請求します。 クエリで特定のパーティションのクエリが必要な場合、MongoDB はパーティションをダウンロードし、ダウンロードされた各パーティションは 1 回のアクセスに対応します。
データ検索
クエリ フィールドと クエリ フィールドに基づいてパーティションを検索するために、Atlas はアーカイブに対して操作を実行します。 Atlas が実行するこのような操作ごとに、最大 1000 個のパーティションが検索されます。 Atlas は、クエリを満たすために必要なパーティションを見つけるために、必要な最小数の操作を実行します。 たとえば、クエリに、クエリ フィールドでカバーされる 100 個のパーティションが必要な場合、Atlas はクエリを満たすために 1 回の操作のみを実行します。
データ転送
フェデレーティッド インフラストラクチャに転送されるデータには、データ転送コストが発生します。
Atlas Online Archive の削除
Atlas CLI、Atlas UI、 APIを使用してオンライン アーカイブを削除できます。 オンライン アーカイブを削除すると、Atlas はオンライン アーカイブ ストレージ上のすべてのファイルとメタデータを 5 日後に削除します。 このデータを削除すると、復元することはできません。
オンライン アーカイブ用に構成されたデータベースまたはコレクションを削除した場合でも、コレクションのデータがアーカイブされている場合は、クラウド オブジェクト ストレージで引き続き利用できます。 クラウド オブジェクト ストレージでのストレージ使用コストが発生します。 あるいは、クラスターを削除すると、Atlas はそのクラスターに設定されたすべてのオンライン アーカイブを削除します。 これにより、クラウド オブジェクト ストレージからアーカイブ データも削除されます。
オンライン アーカイブをすべて削除すると、フェデレーティッドデータベースインスタンスも削除され、オンライン アーカイブを再度作成すると、新しいフェデレーティッドデータベースインスタンスが作成されます。
オンライン アーカイブを削除すると、その状態はDeleted
に移行します。 Active
状態のデータベース、コレクション、フィールドを対象とするオンライン アーカイブが存在しない場合は、削除したオンライン アーカイブと同じデータベース、コレクション、フィールド用に別のオンライン アーカイブを作成できます。
Atlas CLI を使用した Atlas Online Archive の削除
Atlas CLI を使用してクラスターのオンライン アーカイブを削除するには、次のコマンドを実行します。
atlas clusters onlineArchives delete <archiveId> [options]
コマンド構文とパラメータについて詳しくは、Atlas CLI Atlasclusters onlineArchives delete の ドキュメントを参照してください。
UI からの Atlas Online Archive の削除
Atlas UI でオンライン アーカイブを削除するには、以下の手順に従います。
AtlasClusters で、プロジェクトの ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [ Clusters ] をクリックします。
[ Clusters (クラスター) ] ページが表示されます。
Online Archiveクラスターの ページにGoします。
クラスターの名前をクリックします。
[Online Archive] タブをクリックします。
Atlas Online Archiveページが表示されます。
オンライン アーカイブのActions列の省略記号( ...
)をクリックすると、許可されたアクションのリストが表示されます。 ここでは、次の作業が可能です。
Pause Archiving (状態がActiveの場合のみ)
Edit Archive
Delete Archive
Resume Archiving (状態がPausedの場合のみ)
API を介した Atlas Online Archive の削除
APIを通じてオンライン アーカイブを削除するには、削除するオンライン アーカイブの一意の ID を指定して、 OnlineAr ArchivesエンドポイントにDELETE
リクエストを送信します。 構文とオプションの詳細については、「 API 」を参照してください。