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::RAILS_ENV

Constants included from Transactions

Transactions::ACTIONS

Constants included from Callbacks

Callbacks::CALLBACKS

Constants included from AttributeMethods

AttributeMethods::AttrNames, AttributeMethods::BLACKLISTED_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!, #connected?, #connection, #connection_config, #connection_pool, #establish_connection, #mysql2_connection, #postgresql_connection, #remove_connection, #retrieve_connection, #sqlite3_connection

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

#inherited, #initialize_relation_delegate_cache, #relation_delegate_class

Methods included from CollectionCacheKey

#collection_cache_key

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

#add_to_transaction, #before_committed!, #committed!, #destroy, #rollback_active_record_state!, #rolledback!, #save, #save!, #touch, #transaction, #with_transaction_returning_status

Methods included from Aggregations

#initialize_dup, #reload

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

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

Class Method Details

.all_versionsObject



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

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

.create_tableObject



25
26
27
28
29
30
31
32
33
# File 'lib/active_record/schema_migration.rb', line 25

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_tableObject



35
36
37
# File 'lib/active_record/schema_migration.rb', line 35

def drop_table
  connection.drop_table table_name, if_exists: true
end

.normalize_migration_number(number) ⇒ Object



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

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

.normalized_versionsObject



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

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

.primary_keyObject



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

def primary_key
  "version"
end

.table_exists?Boolean

Returns:

  • (Boolean)


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

def table_exists?
  connection.table_exists?(table_name)
end

.table_nameObject



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

def table_name
  "#{table_name_prefix}#{ActiveRecord::Base.schema_migrations_table_name}#{table_name_suffix}"
end

Instance Method Details

#versionObject



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

def version
  super.to_i
end