Contents

# frozen_string_literal: true

require "active_record/explain_registry"

module ActiveRecord
  module Explain
    # Executes the block with the collect flag enabled. Queries are collected
    # asynchronously by the subscriber and returned.
    def collecting_queries_for_explain # :nodoc:
      ExplainRegistry.collect = true
      yield
      ExplainRegistry.queries
    ensure
      ExplainRegistry.reset
    end

    # Makes the adapter execute EXPLAIN for the tuples of queries and bindings.
    # Returns a formatted string ready to be logged.
    def exec_explain(queries) # :nodoc:
      str = queries.map do |sql, binds|
        msg = "EXPLAIN for: #{sql}".dup
        unless binds.empty?
          msg << " "
          msg << binds.map { |attr| render_bind(attr) }.inspect
        end
        msg << "\n"
        msg << connection.explain(sql, binds)
      end.join("\n")

      # Overriding inspect to be more human readable, especially in the console.
      def str.inspect
        self
      end

      str
    end

    private

      def render_bind(attr)
        value = if attr.type.binary? && attr.value
          "<#{attr.value_for_database.to_s.bytesize} bytes of binary data>"
        else
          connection.type_cast(attr.value_for_database)
        end

        [attr.name, value]
      end
  end
end

Version data entries

33 entries across 33 versions & 3 rubygems

Version	Path
activerecord-5.2.8.1	lib/active_record/explain.rb
activerecord-5.2.8	lib/active_record/explain.rb
activerecord-5.2.7.1	lib/active_record/explain.rb
activerecord-5.2.7	lib/active_record/explain.rb
activerecord-5.2.6.3	lib/active_record/explain.rb
activerecord-5.2.6.2	lib/active_record/explain.rb
activerecord-5.2.6.1	lib/active_record/explain.rb
activerecord-5.2.6	lib/active_record/explain.rb
activerecord-5.2.4.6	lib/active_record/explain.rb
activerecord-5.2.5	lib/active_record/explain.rb
activerecord-5.2.4.5	lib/active_record/explain.rb
activerecord-5.2.4.4	lib/active_record/explain.rb
activerecord-5.2.4.3	lib/active_record/explain.rb
activerecord-5.2.4.2	lib/active_record/explain.rb
activerecord-5.2.4.1	lib/active_record/explain.rb
activerecord-5.2.4	lib/active_record/explain.rb
activerecord-5.2.4.rc1	lib/active_record/explain.rb
spiral_form-0.1.1	vendor/bundle/gems/activerecord-5.2.3/lib/active_record/explain.rb
spiral_form-0.1.0	vendor/bundle/gems/activerecord-5.2.3/lib/active_record/explain.rb
activerecord-5.2.3	lib/active_record/explain.rb