Class: ActiveRecord::SchemaMigration

Inherits:
Base
  • Object
show all
Defined in:
lib/active_record/schema_migration.rb

Overview

This class is used to create a table that keeps track of which migrations have been applied to a given database. When a migration is run, its schema number is inserted in to the ‘SchemaMigration.table_name` so it doesn’t need to be executed the next time.

Constant Summary

Constants included from ConnectionHandling

ConnectionHandling::DEFAULT_ENV, ConnectionHandling::ER_BAD_DB_ERROR, ConnectionHandling::RAILS_ENV

Constants included from Querying

Querying::QUERYING_METHODS

Constants included from Transactions

Transactions::ACTIONS

Constants included from Callbacks

Callbacks::CALLBACKS

Constants included from AttributeMethods

AttributeMethods::RESTRICTED_CLASS_METHODS

Instance Attribute Summary

Attributes included from ConnectionHandling

#connection_specification_name

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ConnectionHandling

#clear_cache!, #clear_query_caches_for_current_thread, #connected?, #connected_to, #connected_to?, #connection, #connection_config, #connection_pool, #connects_to, #current_role, #establish_connection, #lookup_connection_handler, #mysql2_connection, #postgresql_connection, #primary_class?, #remove_connection, #resolve_config_for_connection, #retrieve_connection, #sqlite3_connection, #with_handler

Methods included from QueryCache::ClassMethods

#cache, #uncached

Methods included from Querying

#count_by_sql, #find_by_sql

Methods included from Translation

#i18n_scope, #lookup_ancestors

Methods included from Explain

#collecting_queries_for_explain, #exec_explain

Methods included from Enum

#enum, extended, #inherited

Methods included from Delegation::DelegateCache

#generate_relation_method, #inherited, #initialize_relation_delegate_cache, #relation_delegate_class

Methods included from Aggregations::ClassMethods

#composed_of

Methods included from Suppressor

#save, #save!

Methods included from Serialization

#serializable_hash

Methods included from Reflection

add_aggregate_reflection, add_reflection, create

Methods included from NoTouching

applied_to?, apply_to, #no_touching?, #touch, #touch_later

Methods included from TouchLater

#touch, #touch_later

Methods included from Transactions

#before_committed!, #committed!, #destroy, #rolledback!, #save, #save!, #touch, #transaction, #trigger_transactional_callbacks?, #with_transaction_returning_status

Methods included from NestedAttributes

#_destroy

Methods included from AutosaveAssociation

#changed_for_autosave?, #destroyed_by_association, #destroyed_by_association=, #mark_for_destruction, #marked_for_destruction?, #reload

Methods included from Associations

#association, #association_cached?, eager_load!, #initialize_dup, #reload

Methods included from Timestamp

#initialize_dup

Methods included from Callbacks

#destroy, #increment!, #touch

Methods included from AttributeMethods

#[], #[]=, #accessed_fields, #attribute_for_inspect, #attribute_names, #attribute_present?, #attributes, #has_attribute?, #respond_to?

Methods included from Locking::Pessimistic

#lock!, #with_lock

Methods included from Locking::Optimistic

#locking_enabled?

Methods included from Validations

#save, #save!, #valid?

Methods included from Integration

#cache_key, #cache_key_with_version, #cache_version, #to_param

Methods included from Scoping

#initialize_internals_callback, #populate_with_current_scope_attributes

Methods included from Inheritance

#initialize_dup

Methods included from ModelSchema

derive_join_table_name

Methods included from Persistence

#becomes, #becomes!, #decrement, #decrement!, #delete, #destroy, #destroy!, #destroyed?, #increment, #increment!, #new_record?, #persisted?, #reload, #save, #save!, #toggle, #toggle!, #touch, #update, #update!, #update_attribute, #update_column, #update_columns

Methods included from Core

#<=>, #==, #blank?, #connection_handler, #encode_with, #freeze, #frozen?, #hash, #init_with, #init_with_attributes, #initialize, #initialize_dup, #inspect, #present?, #pretty_print, #readonly!, #readonly?, #slice

Class Method Details

._internal? ⇒ Boolean

Returns:

  • (Boolean) 


13
14
15
 
# File 'lib/active_record/schema_migration.rb', line 13

def _internal?
  true
end

.all_versions ⇒ Object 



51
52
53
 
# File 'lib/active_record/schema_migration.rb', line 51

def all_versions
  order(:version).pluck(:version)
end

.create_table ⇒ Object 



29
30
31
32
33
34
35
36
37
 
# File 'lib/active_record/schema_migration.rb', line 29

def create_table
  unless table_exists?
    version_options = connection.internal_string_options_for_primary_key

    connection.create_table(table_name, id: false) do |t|
      t.string :version, **version_options
    end
  end
end

.drop_table ⇒ Object 



39
40
41
 
# File 'lib/active_record/schema_migration.rb', line 39

def drop_table
  connection.drop_table table_name, if_exists: true
end

.normalize_migration_number(number) ⇒ Object 



43
44
45
 
# File 'lib/active_record/schema_migration.rb', line 43

def normalize_migration_number(number)
  "%.3d" % number.to_i
end

.normalized_versions ⇒ Object 



47
48
49
 
# File 'lib/active_record/schema_migration.rb', line 47

def normalized_versions
  all_versions.map { |v| normalize_migration_number v }
end

.primary_key ⇒ Object 



17
18
19
 
# File 'lib/active_record/schema_migration.rb', line 17

def primary_key
  "version"
end

.table_exists? ⇒ Boolean

Returns:

  • (Boolean) 


25
26
27
 
# File 'lib/active_record/schema_migration.rb', line 25

def table_exists?
  connection.table_exists?(table_name)
end

.table_name ⇒ Object 



21
22
23
 
# File 'lib/active_record/schema_migration.rb', line 21

def table_name
  "#{table_name_prefix}#{schema_migrations_table_name}#{table_name_suffix}"
end

Instance Method Details

#version ⇒ Object 



56
57
58
 
# File 'lib/active_record/schema_migration.rb', line 56

def version
  super.to_i
end