activerecord 6.1.6 → 7.1.2

data/lib/active_record/connection_adapters/schema_cache.rb

@@ -4,8 +4,234 @@ require "active_support/core_ext/file/atomic"
 
 module ActiveRecord
   module ConnectionAdapters
+    class SchemaReflection
+      class << self
+        attr_accessor :use_schema_cache_dump
+        attr_accessor :check_schema_cache_dump_version
+      end
+
+      self.use_schema_cache_dump = true
+      self.check_schema_cache_dump_version = true
+
+      def initialize(cache_path, cache = nil)
+        @cache = cache
+        @cache_path = cache_path
+      end
+
+      def set_schema_cache(cache)
+        @cache = cache
+      end
+
+      def clear!
+        @cache = empty_cache
+
+        nil
+      end
+
+      def load!(connection)
+        cache(connection)
+
+        self
+      end
+
+      def primary_keys(connection, table_name)
+        cache(connection).primary_keys(connection, table_name)
+      end
+
+      def data_source_exists?(connection, name)
+        cache(connection).data_source_exists?(connection, name)
+      end
+
+      def add(connection, name)
+        cache(connection).add(connection, name)
+      end
+
+      def data_sources(connection, name)
+        cache(connection).data_sources(connection, name)
+      end
+
+      def columns(connection, table_name)
+        cache(connection).columns(connection, table_name)
+      end
+
+      def columns_hash(connection, table_name)
+        cache(connection).columns_hash(connection, table_name)
+      end
+
+      def columns_hash?(connection, table_name)
+        cache(connection).columns_hash?(connection, table_name)
+      end
+
+      def indexes(connection, table_name)
+        cache(connection).indexes(connection, table_name)
+      end
+
+      def database_version(connection) # :nodoc:
+        cache(connection).database_version(connection)
+      end
+
+      def version(connection)
+        cache(connection).version(connection)
+      end
+
+      def size(connection)
+        cache(connection).size
+      end
+
+      def clear_data_source_cache!(connection, name)
+        return if @cache.nil? && !possible_cache_available?
+
+        cache(connection).clear_data_source_cache!(connection, name)
+      end
+
+      def cached?(table_name)
+        if @cache.nil?
+          # If `check_schema_cache_dump_version` is enabled we can't load
+          # the schema cache dump without connecting to the database.
+          unless self.class.check_schema_cache_dump_version
+            @cache = load_cache(nil)
+          end
+        end
+
+        @cache&.cached?(table_name)
+      end
+
+      def dump_to(connection, filename)
+        fresh_cache = empty_cache
+        fresh_cache.add_all(connection)
+        fresh_cache.dump_to(filename)
+
+        @cache = fresh_cache
+      end
+
+      private
+        def empty_cache
+          new_cache = SchemaCache.allocate
+          new_cache.send(:initialize)
+          new_cache
+        end
+
+        def cache(connection)
+          @cache ||= load_cache(connection) || empty_cache
+        end
+
+        def possible_cache_available?
+          self.class.use_schema_cache_dump &&
+            @cache_path &&
+            File.file?(@cache_path)
+        end
+
+        def load_cache(connection)
+          # Can't load if schema dumps are disabled
+          return unless possible_cache_available?
+
+          # Check we can find one
+          return unless new_cache = SchemaCache._load_from(@cache_path)
+
+          if self.class.check_schema_cache_dump_version
+            begin
+              current_version = connection.schema_version
+
+              if new_cache.version(connection) != current_version
+                warn "Ignoring #{@cache_path} because it has expired. The current schema version is #{current_version}, but the one in the schema cache file is #{new_cache.schema_version}."
+                return
+              end
+            rescue ActiveRecordError => error
+              warn "Failed to validate the schema cache because of #{error.class}: #{error.message}"
+              return
+            end
+          end
+
+          new_cache
+        end
+    end
+
+    class BoundSchemaReflection
+      def initialize(abstract_schema_reflection, connection)
+        @schema_reflection = abstract_schema_reflection
+        @connection = connection
+      end
+
+      def clear!
+        @schema_reflection.clear!
+      end
+
+      def load!
+        @schema_reflection.load!(@connection)
+      end
+
+      def cached?(table_name)
+        @schema_reflection.cached?(table_name)
+      end
+
+      def primary_keys(table_name)
+        @schema_reflection.primary_keys(@connection, table_name)
+      end
+
+      def data_source_exists?(name)
+        @schema_reflection.data_source_exists?(@connection, name)
+      end
+
+      def add(name)
+        @schema_reflection.add(@connection, name)
+      end
+
+      def data_sources(name)
+        @schema_reflection.data_sources(@connection, name)
+      end
+
+      def columns(table_name)
+        @schema_reflection.columns(@connection, table_name)
+      end
+
+      def columns_hash(table_name)
+        @schema_reflection.columns_hash(@connection, table_name)
+      end
+
+      def columns_hash?(table_name)
+        @schema_reflection.columns_hash?(@connection, table_name)
+      end
+
+      def indexes(table_name)
+        @schema_reflection.indexes(@connection, table_name)
+      end
+
+      def database_version # :nodoc:
+        @schema_reflection.database_version(@connection)
+      end
+
+      def version
+        @schema_reflection.version(@connection)
+      end
+
+      def size
+        @schema_reflection.size(@connection)
+      end
+
+      def clear_data_source_cache!(name)
+        @schema_reflection.clear_data_source_cache!(@connection, name)
+      end
+
+      def dump_to(filename)
+        @schema_reflection.dump_to(@connection, filename)
+      end
+    end
+
+    # = Active Record Connection Adapters Schema Cache
     class SchemaCache
-      def self.load_from(filename)
+      class << self
+        def new(connection)
+          BoundSchemaReflection.new(SchemaReflection.new(nil), connection)
+        end
+        deprecate new: "use ActiveRecord::ConnectionAdapters::SchemaReflection instead", deprecator: ActiveRecord.deprecator
+
+        def load_from(filename) # :nodoc:
+          BoundSchemaReflection.new(SchemaReflection.new(filename), nil)
+        end
+        deprecate load_from: "use ActiveRecord::ConnectionAdapters::SchemaReflection instead", deprecator: ActiveRecord.deprecator
+      end
+
+      def self._load_from(filename) # :nodoc:
         return unless File.file?(filename)
 
         read(filename) do |file|
@@ -32,20 +258,17 @@ module ActiveRecord
       end
       private_class_method :read
 
-      attr_reader :version
-      attr_accessor :connection
-
-      def initialize(conn)
-        @connection = conn
-
+      def initialize
         @columns      = {}
         @columns_hash = {}
         @primary_keys = {}
         @data_sources = {}
         @indexes      = {}
+        @database_version = nil
+        @version = nil
       end
 
-      def initialize_dup(other)
+      def initialize_dup(other) # :nodoc:
         super
         @columns      = @columns.dup
         @columns_hash = @columns_hash.dup
@@ -54,60 +277,71 @@ module ActiveRecord
         @indexes      = @indexes.dup
       end
 
-      def encode_with(coder)
-        reset_version!
-
-        coder["columns"]          = @columns
-        coder["primary_keys"]     = @primary_keys
-        coder["data_sources"]     = @data_sources
-        coder["indexes"]          = @indexes
+      def encode_with(coder) # :nodoc:
+        coder["columns"]          = @columns.sort.to_h
+        coder["primary_keys"]     = @primary_keys.sort.to_h
+        coder["data_sources"]     = @data_sources.sort.to_h
+        coder["indexes"]          = @indexes.sort.to_h
         coder["version"]          = @version
-        coder["database_version"] = database_version
+        coder["database_version"] = @database_version
       end
 
       def init_with(coder)
         @columns          = coder["columns"]
+        @columns_hash     = coder["columns_hash"]
         @primary_keys     = coder["primary_keys"]
         @data_sources     = coder["data_sources"]
         @indexes          = coder["indexes"] || {}
         @version          = coder["version"]
         @database_version = coder["database_version"]
 
-        derive_columns_hash_and_deduplicate_values
+        unless coder["deduplicated"]
+          derive_columns_hash_and_deduplicate_values
+        end
       end
 
-      def primary_keys(table_name)
+      def cached?(table_name)
+        @columns.key?(table_name)
+      end
+
+      def primary_keys(connection, table_name)
         @primary_keys.fetch(table_name) do
-          if data_source_exists?(table_name)
+          if data_source_exists?(connection, table_name)
             @primary_keys[deep_deduplicate(table_name)] = deep_deduplicate(connection.primary_key(table_name))
           end
         end
       end
 
       # A cached lookup for table existence.
-      def data_source_exists?(name)
-        prepare_data_sources if @data_sources.empty?
+      def data_source_exists?(connection, name)
+        return if ignored_table?(name)
+        prepare_data_sources(connection) if @data_sources.empty?
         return @data_sources[name] if @data_sources.key? name
 
         @data_sources[deep_deduplicate(name)] = connection.data_source_exists?(name)
       end
 
       # Add internal cache for table with +table_name+.
-      def add(table_name)
-        if data_source_exists?(table_name)
-          primary_keys(table_name)
-          columns(table_name)
-          columns_hash(table_name)
-          indexes(table_name)
+      def add(connection, table_name)
+        if data_source_exists?(connection, table_name)
+          primary_keys(connection, table_name)
+          columns(connection, table_name)
+          columns_hash(connection, table_name)
+          indexes(connection, table_name)
         end
       end
 
-      def data_sources(name)
+      def data_sources(_connection, name) # :nodoc:
         @data_sources[name]
       end
+      deprecate data_sources: :data_source_exists?, deprecator: ActiveRecord.deprecator
 
       # Get the columns for a table
-      def columns(table_name)
+      def columns(connection, table_name)
+        if ignored_table?(table_name)
+          raise ActiveRecord::StatementInvalid, "Table '#{table_name}' doesn't exist"
+        end
+
         @columns.fetch(table_name) do
           @columns[deep_deduplicate(table_name)] = deep_deduplicate(connection.columns(table_name))
         end
@@ -115,36 +349,37 @@ module ActiveRecord
 
       # Get the columns for a table as a hash, key is the column name
       # value is the column object.
-      def columns_hash(table_name)
+      def columns_hash(connection, table_name)
         @columns_hash.fetch(table_name) do
-          @columns_hash[deep_deduplicate(table_name)] = columns(table_name).index_by(&:name).freeze
+          @columns_hash[deep_deduplicate(table_name)] = columns(connection, table_name).index_by(&:name).freeze
         end
       end
 
       # Checks whether the columns hash is already cached for a table.
-      def columns_hash?(table_name)
+      def columns_hash?(connection, table_name)
         @columns_hash.key?(table_name)
       end
 
-      def indexes(table_name)
+      def indexes(connection, table_name)
         @indexes.fetch(table_name) do
-          @indexes[deep_deduplicate(table_name)] = deep_deduplicate(connection.indexes(table_name))
+          if data_source_exists?(connection, table_name)
+            @indexes[deep_deduplicate(table_name)] = deep_deduplicate(connection.indexes(table_name))
+          else
+            []
+          end
         end
       end
 
-      def database_version # :nodoc:
+      def database_version(connection) # :nodoc:
         @database_version ||= connection.get_database_version
       end
 
-      # Clears out internal caches
-      def clear!
-        @columns.clear
-        @columns_hash.clear
-        @primary_keys.clear
-        @data_sources.clear
-        @indexes.clear
-        @version = nil
-        @database_version = nil
+      def version(connection)
+        @version ||= connection.schema_version
+      end
+
+      def schema_version
+        @version
       end
 
       def size
@@ -152,7 +387,7 @@ module ActiveRecord
       end
 
       # Clear out internal caches for the data source +name+.
-      def clear_data_source_cache!(name)
+      def clear_data_source_cache!(_connection, name)
         @columns.delete name
         @columns_hash.delete name
         @primary_keys.delete name
@@ -160,9 +395,16 @@ module ActiveRecord
         @indexes.delete name
       end
 
+      def add_all(connection) # :nodoc:
+        tables_to_cache(connection).each do |table|
+          add(connection, table)
+        end
+
+        version(connection)
+        database_version(connection)
+      end
+
       def dump_to(filename)
-        clear!
-        connection.data_sources.each { |table| add(table) }
         open(filename) { |f|
           if filename.include?(".dump")
             f.write(Marshal.dump(self))
@@ -172,13 +414,11 @@ module ActiveRecord
         }
       end
 
-      def marshal_dump
-        reset_version!
-
-        [@version, @columns, {}, @primary_keys, @data_sources, @indexes, database_version]
+      def marshal_dump # :nodoc:
+        [@version, @columns, {}, @primary_keys, @data_sources, @indexes, @database_version]
       end
 
-      def marshal_load(array)
+      def marshal_load(array) # :nodoc:
         @version, @columns, _columns_hash, @primary_keys, @data_sources, @indexes, @database_version = array
         @indexes ||= {}
 
@@ -186,8 +426,16 @@ module ActiveRecord
       end
 
       private
-        def reset_version!
-          @version = connection.migration_context.current_version
+        def tables_to_cache(connection)
+          connection.data_sources.reject do |table|
+            ignored_table?(table)
+          end
+        end
+
+        def ignored_table?(table_name)
+          ActiveRecord.schema_cache_ignored_tables.any? do |ignored|
+            ignored === table_name
+          end
         end
 
         def derive_columns_hash_and_deduplicate_values
@@ -198,51 +446,32 @@ module ActiveRecord
           @indexes      = deep_deduplicate(@indexes)
         end
 
-        if RUBY_VERSION < "2.7"
-          def deep_deduplicate(value)
-            case value
-            when Hash
-              value.transform_keys { |k| deep_deduplicate(k) }.transform_values { |v| deep_deduplicate(v) }
-            when Array
-              value.map { |i| deep_deduplicate(i) }
-            when String
-              if value.tainted?
-                # Ruby 2.6 and 2.7 have slightly different implementations of the String#-@ method.
-                # In Ruby 2.6, the receiver of the String#-@ method is modified under certain
-                # circumstances, and this was later identified as a bug
-                # (https://bugs.ruby-lang.org/issues/15926) and only fixed in Ruby 2.7.
-                value = value.dup
-              end
-              -value
-            when Deduplicable
-              -value
-            else
-              value
-            end
-          end
-        else
-          def deep_deduplicate(value)
-            case value
-            when Hash
-              value.transform_keys { |k| deep_deduplicate(k) }.transform_values { |v| deep_deduplicate(v) }
-            when Array
-              value.map { |i| deep_deduplicate(i) }
-            when String, Deduplicable
-              -value
-            else
-              value
-            end
+        def deep_deduplicate(value)
+          case value
+          when Hash
+            value.transform_keys { |k| deep_deduplicate(k) }.transform_values { |v| deep_deduplicate(v) }
+          when Array
+            value.map { |i| deep_deduplicate(i) }
+          when String, Deduplicable
+            -value
+          else
+            value
           end
         end
 
-        def prepare_data_sources
-          connection.data_sources.each { |source| @data_sources[source] = true }
+        def prepare_data_sources(connection)
+          tables_to_cache(connection).each do |source|
+            @data_sources[source] = true
+          end
         end
 
         def open(filename)
+          FileUtils.mkdir_p(File.dirname(filename))
+
           File.atomic_write(filename) do |file|
             if File.extname(filename) == ".gz"
               zipper = Zlib::GzipWriter.new file
+              zipper.mtime = 0
               yield zipper
               zipper.flush
               zipper.close

data/lib/active_record/connection_adapters/sqlite3/column.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module ActiveRecord
+  module ConnectionAdapters
+    module SQLite3
+      class Column < ConnectionAdapters::Column # :nodoc:
+        attr_reader :rowid
+
+        def initialize(*, auto_increment: nil, rowid: false, **)
+          super
+          @auto_increment = auto_increment
+          @rowid = rowid
+        end
+
+        def auto_increment?
+          @auto_increment
+        end
+
+        def auto_incremented_by_db?
+          auto_increment? || rowid
+        end
+
+        def init_with(coder)
+          @auto_increment = coder["auto_increment"]
+          super
+        end
+
+        def encode_with(coder)
+          coder["auto_increment"] = @auto_increment
+          super
+        end
+
+        def ==(other)
+          other.is_a?(Column) &&
+            super &&
+            auto_increment? == other.auto_increment?
+        end
+        alias :eql? :==
+
+        def hash
+          Column.hash ^
+            super.hash ^
+            auto_increment?.hash ^
+            rowid.hash
+        end
+      end
+    end
+  end
+end