履歴Platform Analyticsトランザクションレベルデータをクラウドストレージにアーカイブする

Strategy One（2025年10月）以降、環境の履歴テーブルから未使用の古いデータをクラウドストレージに移動して、Platform Analyticsウェアハウスのサイズを削減できます。必要に応じて、履歴データを復元できます。古いデータをアーカイブする利点には、次のものがあります。

• データベースサイズの削減

• クエリパフォーマンスの向上

アーカイブは、AWS Cloudでのインスタンスベースおよびコンテナベースの両方のデプロイメントでサポートされています。

構成

環境はクラウドアップロード機能（S3へ）を持つ必要があります。

• コンテナベース環境の場合、次の環境変数を使用して構成します。

  変数	説明	例	デフォルト
  HISTORICAL_RETENTION_CUTOFF_DAYS	データベースに保持する履歴データの日数	365	365
  DEPLOYMENT_TYPE	デプロイメントタイプ MCEのみ	mce
  DEPLOYMENT_MODE	クラウドプロバイダー	aws
  BUCKET_NAME	ターゲットクラウドストレージバケット名	mci-prod-archive
  ENV_ID	一意の環境ID	test2

• インスタンスベース環境の場合、以下に示すようにarchive-config.yamlファイルを使用します。

  コピー

  configuration:
    historicalRetentionCutoffDays: 365
    deploymentType: mce
    deploymentMode: aws
    bucketName: mci-dev-pa
    envId: test2
  

バックアッププロセス

バックアッププロセスは、PAConsumerConfig.yamlファイルでスケジュールされている日次Extract、Transform、Load（ETL）プロセスの一部としてトリガーされます。プロセスは毎日トリガーされますが、バックアップは過去7日間について週次ベースで実行されます。

復元プロセス

復元APIを使用すると、特定の期間のデータを復元できます。開始日と終了日を指定します。復元プロセスは、開始日と終了日を含む1週間分のデータを復元します。

必要な権限

次の権限が必要です。

• すべてのオブジェクトセキュリティアクセスチェックをバイパス

• 環境を管理

ステータスAPI

復元が実行されているかどうか、および完了したバックアップの数を確認します。

リクエスト：

GET /api/telemetry/admin/restore/status

復元API

日付範囲間の復元をトリガーします。

リクエスト：

POST /api/telemetry/admin/restore

ボディ：

{
  "startDate": "2023-12-04",
  "endDate": "2024-10-01"
}

追跡とモニタリング

Platform Analyticsウェアハウス内のhistorical_table_backup_trackerテーブルは、バックアップおよび復元操作を監視するために使用されます。テーブルで追跡する重要なフィールドは次のとおりです。