Can Queueable run in parallel with calling transaction?

Question

SimpleQueueable.cls:

public with sharing class SimpleQueueable implements System.Queueable{
    public void execute(System.QueueableContext ctxt){
        //query the record inserted in calling transaction
        //make some changes on the record and update the record.
    }
}

Sample code of calling transaction:

SimpleQueueable job = new SimpleQueueable();
System.enqueueJob(job);
Long start = System.now().getTime();
while(System.now().getTime() - start < 6000 ){
}
// Decimal x = 6/0; If I uncomment this line queueable is not running.

Behavior of Queueable job :

Only run if calling transaction completes successfully.
Only run after the completion of calling transaction and should not run in parallel with calling transaction.
Query the record that is inserted in the calling transaction and do some updates and update the record.

About calling transaction:

Calling transaction starts with custom code and ends with managed package code. So, I don't have a way to know when the calling transaction ends.

What I have noticed:

If the calling transaction is failing then queueuable is not executed.
Queueable job is executed after the calling transaction is completed.

Can someone confirm this or my findings wrong?

score 3 · Accepted Answer · answered Oct 19 '19 at 21:09

If the calling transaction is failing then queueuable is not executed.

Queueable job is executed after the calling transaction is completed.

This is correct. Whenever you invoke Asynchronous Apex (whether Queueable, Batch, Scheduled, or Future), your request is persisted to the queue when your transaction commits successfully.

If an unhandled exception is thrown (or a rollback operation is otherwise performed), all enqueued asynchronous Apex will be rolled back along with regular sObject DML.

score 2 · Answer 2 · answered Oct 19 '19 at 21:07

100% - like all async processing this is handled by creating a record in the database which is consumed by the Salesforce runtime at a later point based on processing availability and schedule. For the async processing to happen, therefore, the transaction must have finished since this is when the database transaction itself is finalized.

score 1 · Answer 3 · answered Oct 20 '19 at 00:13

As a more generic answer: everything that occurs "at the end of a transaction" will not happen if you fail to reach the natural end of the transaction successfully, either by governor limits, an unhandled exception, or an addError/validation rule that causes the records to roll back. This includes scheduling jobs, sending emails, running Queueable and Batchable jobs, triggering Outbound Messaging (Workflow), and some Platform Events (those configured to fire on successful transactions only). Also, you can achieve similar effects with SavePoint/rollback, such as:

SavePoint sp = Database.setSavePoint();
MyUtil.sendSomeEmails();
MyUtil.doSomeBatchableStuff();
MyUtil.doQueueableStuffToo();
// None of the above actually "happened" as far as the database is concerned!
Database.rollback(sp);

So, because of this behavior, you can guarantee that the Batchable/Queueable/Schedulable/Emails cannot occur before the transaction ends, with the exception of the "immediate send" Platform Events.

Can Queueable run in parallel with calling transaction?

3 Answers3

Linked