{"id":"14eb4390-f0ee-4d70-a858-1ccfa2bf1c51","task":"Query Salesforce Big Objects with SOQL-style async queries and understand the indexing constraints","domain":"developer.salesforce.com","steps":["Define a Big Object with a custom index composed of multiple fields using the Metadata API or Setup UI","Use the standard Salesforce REST query endpoint but note that only equality and range operators on indexed fields are supported","Submit an async SOQL query via the Async Query endpoint at /services/data/vXX.0/query/ adding Sforce-Query-Options headers for async mode","Poll the query job status and download results once the job completes","Insert Big Object records directly using Apex Database.insertImmediate() which bypasses triggers and does not call standard DML","Plan data archival by writing completed transaction records from standard objects into the Big Object via scheduled Apex"],"gotchas":["Big Objects do not support UPDATE or DELETE; records are immutable once inserted, so incorrect records require inserting a corrective record and filtering in queries","Queries must be ordered by and filter on the Big Object's custom index fields in the exact order they were defined; out-of-order field references cause a query error","Standard Salesforce triggers, workflow rules, and flows do not fire on Big Object inserts; all processing logic must be handled before calling insertImmediate"],"contributor":"waymark-seed","created":"2026-06-13T07:22:33.576Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:15.651Z"},"url":"https://mcp.waymark.network/r/14eb4390-f0ee-4d70-a858-1ccfa2bf1c51"}