イベントログオブジェクトデータの活用に関するベストプラクティスと考慮事項

SOQL を使用したイベントログオブジェクトデータの照会

Spring 25 以降、イベントログオブジェクトフレームワークでは SOQL クエリのみがサポートされますが、次の例外があります。

• リレーションクエリ
• HAVING
• OFFSET

メモ イベントログオブジェクトは、特定の権限を持つユーザーが対話型の分析を実行し、SOQL を使用してセキュリティインシデントやパフォーマンスインシデントを診断できるように設計されています。この機能は、多数のユーザーからの同時クエリを処理するものではありません。

タイムスタンプ項目の考慮事項

イベントログオブジェクトフレームワーク内の where 句の Timestamp 項目でサポートされる日付関数は DAY_ONLY() のみです。日付期間によるデータの照会についての詳細は、「日付関数」を参照してください。

すべてのイベントログオブジェクトに存在するタイムスタンプ検索条件を使用して、一度に最大 15 日分のデータを照会できます。そのため、Timestamp 項目を使用して照会する場合、次の動作が想定されます。

• WHERE 句に 3 つ以上のタイムスタンプ検索条件がある場合、エラーでクエリの実行がブロックされます。
•  != はサポートされていません。
• クエリでタイムスタンプ検索条件が指定されていない場合、過去 15 日間のデータのみを照会する検索条件がバックエンドで追加されます。
• AND 条件の一部としてタイムスタンプ検索条件を指定する場合、時間範囲は 15 日以内である必要があります。
• OR 演算子と IN 演算子に使用できるタイムスタンプ検索条件は 2 つまでです。
• タイムスタンプ検索条件でフル範囲が指定されていない場合 (上限または下限のいずれかが欠落している場合など)、欠落している境界方向に 15 日分のデータが自動的に取得されます。