高度なデータ・ライフサイクル管理のベスト・プラクティス
Advanced Data Lifecycle Management UI と Data Hygiene API を使用して、クリーンアップリクエストを効率的に管理し、Adobe Experience Platform サービスからデータを削除します。 これらのベストプラクティスに従って、リクエスト処理を効率化し、完了までの応答時間を最適化します。
前提条件 prerequisites
このガイドでは、Data Lifecycle ワークスペースと Data Hygiene API について、実際に理解している必要があります。 このドキュメントを続行する前に、 高度なデータライフサイクル管理 、 レコード削除リクエストの作成 または UI でのデータセット有効期限 や API に関するガイドを熟知してください。
作業指示の作成ガイドライン work-order-creation-guidelines
Data Hygiene API の /workorder エンドポイントを使用して、Experience Platformのレコード削除リクエストをプログラムで管理できます。 このエンドポイントを使用すると、削除リクエストの作成、そのステータスの確認、既存のリクエストの更新をおこなうことができます。 API を使用してこれらのアクションを実行する方法については、 作業指示エンドポイントのドキュメント を参照してください。
クリーンアップリクエストの送信を最適化するには、次のガイドラインに従います。
- リクエストあたりの ID の最大化： クリーンアップリクエストあたり最大 100,000 個の ID を含めて、効率を向上させます。 複数の ID を 1 つのリクエストにバッチ処理すると、API 呼び出しの頻度を減らし、過剰な単一 ID 要求に起因するパフォーマンスの問題のリスクを最小限に抑えることができます。 作業指示が効率のためにバッチ処理されるので、処理を高速化するために、ID 数の上限を設定してリクエストを送信します。
- 個々のデータセットを指定： 効率を最大限に高めるには、処理する個々のデータセットを指定します。
- API スロットルに関する考慮事項： API スロットルには、速度低下を防ぐために注意してください。 より高い頻度で小さいリクエスト（100 未満の ID）を行うと、429 の応答が返され、許容可能な割合で再送信が必要になる場合があります。
429 エラーの管理 manage-429-errors
429 エラーが表示された場合は、特定の期間内に許可されているリクエスト数を超えていることを示しています。 次のベストプラクティスに従って、429 エラーを効果的に管理します。
- 「Retry-After」ヘッダーを読む:429 エラーが返されたら、「Retry-After」応答ヘッダーを確認します。 このヘッダーでは、リクエストを再試行するまでの待機時間を指定します。
- 再試行ロジックの実装: 「Retry-After」値を使用してアプリケーションに再試行ロジックを実装し、後続の 429 エラーを回避するために指定した時間後に再試行が試みられるようにします。
- リクエストのバッチ処理：多数の小さなリクエストを短時間に連続して送信することは避けます。 代わりに、複数の ID を 1 つのリクエストにバッチ化して、呼び出しの頻度を減らし、レート制限に達するリスクを最小限に抑えます。
データセットの有効期限 dataset-expiration
短時間のみ有効なデータのデータセットクリーンアップの自動設定。 Data Hygiene API の /ttl エンドポイントを使用して、指定した時間または日付に基づいてデータセットの有効期限をクリーンアップ用にスケジュールします。 データセット有効期限の作成 および 受け入れ可能なクエリパラメーター の方法については、データセット有効期限のエンドポイントガイドを参照してください。
作業指示およびデータセットの有効期限ステータスの監視 monitor
I/O イベント を使用すると、データライフサイクル管理の進行状況を効率的に監視できます。 I/O イベントは、Experience Platform内の様々なサービスの変更や更新に関する通知をリアルタイムで受け取るためのメカニズムです。
I/O イベントアラートを設定済みの Webhook に送信して、アクティビティ監視を自動化できます。 Webhook を介してアラートを受信するには、Adobe Developer ConsoleでExperience Platform アラートの Webhook を登録する必要があります。 詳しくは、Adobe I/O イベント通知の登録 のガイドを参照してください。
次のデータ・ライフサイクル・メソッドおよびガイドラインを使用して、ジョブ・ステータスを効果的に取得および監視します。
I/O イベント io-events
データ・ライフサイクル・タスクの進行状況を効率的に監視するには、次の手順に従って I/O イベントを設定および使用します。
- ステータスの変更に関するプッシュ通知を受信する Webhook を設定します。
- 通知を使用して進行状況を監視し、完了時に更新を受け取ります。
- API トラフィックを最小限に抑えるためにポーリングメカニズムを実装しないでください。
1 つの作業指示に対する詳細な応答の取得 retrieve-detailed-work-order-response
個々の作業指示について詳しくは、次の方法を使用します。
/workorder/{work_order_id}エンドポイントに対してGET リクエストを実行し、詳細な応答データを取得します。- 製品固有の応答と成功メッセージを取得します。
- 通常のポーリングアクティビティには、この方法を使用しないでください。
これらのベストプラクティスに従うことで、クリーンアップリクエストを効果的に管理し、高度なデータライフサイクル管理内での応答時間を最適化できます。