BackgroundOperationResult
非同期 SOQL クエリを実行するか、Bulk API を使用して Big Object にデータをインポートしたときに生成されたエラーメッセージが保存されます。これは、API バージョン 37.0 以降で使用可能な Big Object です。
BackgroundOperationResult の各インスタンスが 1 つのエラーを表します。Message 項目にはエラーメッセージのテキス���が保存されます。ParentID 項目には次の情報が保存されます。
- 非同期 SOQL の場合はクエリのジョブ ID
- Bulk API の場合は、データインポートのバッチ ID
Bulk API がインポート時にデータを検証し、データファイルのいずれかの行で無効なデータが最初に出現したらエラーメッセージを生成します。実行される検証は、インポートされるデータの型に応じて異なります。
- Text — 入力文字列の長さは、対象オブジェクトの対応するテキスト項目の長さ以下である必要があります。
- Number — 入力データは、スケールと精度が対象オブジェクトの対応する数値項目と互換性のある数値である必要があります。
- ID — 入力データは有効な 15 または 18 文字の ID である必要があります。
- DateTime — 入力データは、承認された形式の有効な dateTime 値である必要があります。
- Lookup — ルックアップ値は有効な 15 または 18 文字の ID である必要があります。
項目
| 項目名 | 詳細 |
|---|---|
| CreatedById |
|
| CreatedDate |
|
| Data |
|
| Id |
|
| Message |
|
| MessageType |
|
| ParentId |
|
使用方法
BackgroundOperationResult オブジェクトをクエリしてエラーがないか確認できます。たとえば、次のクエリはバッチ ID 751xx000000006OAAQ の Bulk API を使用してインポートされたデータファイル内のすべてのエラーの詳細を返します。
1SELECT CreatedbyId, CreatedDate, Id, Message, MessageType, ParentId FROM BackgroundOperationResult WHERE ParentId = “751xx000000006OAAQ”