Newer Version Available

This content describes an older version of this product. View Latest

QueryOptions

Specifies the batch size for queries. Batches that are larger or smaller than the specified size may be used, in order to maximize performance.

Associated API Calls

query(), queryMore(), retrieve()

Fields

Element Name Type Description
batchSize int

The batch size for the number of records returned in a query() or queryMore() call. Child objects count toward the number of records for the batch size. For example, in relationship queries, multiple child objects may be returned per parent row returned.

The default is 500; the minimum is 200, and the maximum is 2,000. There is no guarantee that the requested batch size will be the actual batch size; this is done to maximize performance.

Sample Code

For code examples, see Change the Batch Size in Queries in the Salesforce SOQL and SOSL Reference Guide.