method

load_async

v7.1.3.4 - Show latest stable - 0 notes - Class: ActiveRecord::Relation

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1
2.3.8
3.0.0
3.0.9
3.1.0
3.2.1
3.2.8
3.2.13
4.0.2
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7
5.2.3
6.0.0
6.1.3.1
6.1.7.7
7.0.0 (0)
7.1.3.2 (38)
7.1.3.4 (0)
What's this?

load_async() public

Schedule the query to be performed from a background thread pool.

Post.where(published: true).load_async # => #<ActiveRecord::Relation>

When the Relation is iterated, if the background query wasn’t executed yet, it will be performed by the foreground thread.

Note that config.active_record.async_query_executor must be configured for queries to actually be executed concurrently. Otherwise it defaults to executing them in the foreground.

load_async will also fall back to executing in the foreground in the test environment when transactional fixtures are enabled.

If the query was actually executed in the background, the Active Record logs will show it by prefixing the log line with ASYNC:

ASYNC Post Load (0.0ms) (db time 2ms)  SELECT "posts".* FROM "posts" LIMIT 100

Show source

# File activerecord/lib/active_record/relation.rb, line 711
    def load_async
      return load if !connection.async_enabled?

      unless loaded?
        result = exec_main_query(async: connection.current_transaction.closed?)

        if result.is_a?(Array)
          @records = result
        else
          @future_result = result
        end
        @loaded = true
      end

      self
    end

load_async

Related methods