Rails Adds ActiveRecord::Base.with_connection To Optimize Database Operations.

In Rails, ActiveRecord is a powerful ORM (Object-Relational Mapping) framework that simplifies database interactions.

Efficient management of database connections is crucial for ensuring the performance and scalability of applications.


ActiveRecord::Base.connection enables direct access to the currently active database connection. It holds database connections until the end of the request cycle, ensuring they are available for the duration of the request processing.

However, relying on ActiveRecord::Base.connection can cause performance issues for applications with high I/O (input/output) demands, such as those heavily interacting with third-party APIs. These applications require higher concurrency for optimal performance.

Holding connections until the end of the request cycle results in many idle, unavailable connections, reducing concurrency and limiting resource utilization.


Rails introduces ActiveRecord::Base.with_connection to optimize database connections for high concurrency and IO-intensive applications by providing a more controlled approach to manage database connections.

ActiveRecord::Base.with_connection do |conn|
  puts "ActiveRecord::Base.with_connection is available!"

  # Perform database operations using the leased connection
  conn.execute("SELECT * FROM users WHERE id = 1")

Unlike ActiveRecord::Base.connection, which holds connections until the end of the request cycle, with_connection obtain a database connection from the connection pool, yields it to a block of code, and then returns it to the pool after execution for immediate reuse.

This method is useful for managing database connections within a block of code, ensuring dedicated connections for specific operations or multiple operations within a single transaction.

It also enhances concurrency in high IO scenarios, such as interactions with third-party APIs, by preventing unnecessary connection holding.

# Let's say by default we have 5 pool connections 
ActiveRecord::Base.with_connection do |conn|
  conn.transaction do

    # Leases out 1 connection to perform database operations within the transaction

    User.update_all(status: 'active')
    Post.create(title: 'New Post', body: 'Lorem ipsum dolor sit amet.')

  # connection returned to pool and now we have 5

Use Cases and Benefits:

Transactional Integrity: Ensures all database operations within a scoped block share the same connection, maintaining consistency and atomicity of transactions.

Raw SQL Queries: Facilitates execution of complex raw SQL queries beyond ActiveRecord’s query interface.

Simplified Code: Abstracts away connection management complexities, leading to cleaner and more understandable code.

Performance Optimization:: Leases connections only for the block’s duration, preventing leaks, unnecessary holding and optimizing resource usage.


At its core, ActiveRecord::Base.with_connection serves as a mechanism for temporarily leasing a database connection within a specific scope. When invoked, it provides a database connection that can be utilized within a block of code, ensuring that all database operations within the block share the same connection.

This temporary leasing of connections facilitates efficient resource management and enhances the performance of database operations and promotes transactional integrity.

Need help on your Ruby on Rails or React project?

Join Our Newsletter