Page History

...

• If an operator is processing one batch at a time, this means that it can safely free attached resources after it processes each batch.
• If an operator is accumulating batches, this means that it must be careful not to destroy or reset a batch if previous batches are still in use, because this could release memory resources that are used by the previous batches.

Note: there is another Another deprecated mechanism called also exists: need_to_return()/MarkNeedToReturn(). If GetNext() returns a batch with the need_to_return() that isn't documented hereflag set, it means that the batch may reference memory that will be freed on the next GetNext() call. If the caller wants to retain the batch's data, it need to copy the batch.