The SQLite3 adapter works SQLite 3.6.16 or newer with the sqlite3-ruby drivers (available as gem from rubygems.org/gems/sqlite3).
Options:
:database - Path to the database file.
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 101
def self.database_exists?(config)
config = config.symbolize_keys
if config[:database] == ":memory:"
return true
else
database_file = defined?(Rails.root) ? File.expand_path(config[:database], Rails.root) : config[:database]
File.exist?(database_file)
end
end # File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 96 def initialize(connection, logger, connection_options, config) super(connection, logger, config) configure_connection end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 154 def active? [email protected]? end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 177 def allowed_index_name_length index_name_length - 2 end
Returns 62. SQLite supports index names up to 64 characters. The rest is used by Rails internally to perform temporary rename operations
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 165 def disconnect! super @connection.close rescue nil end
Disconnects from the database if already connected. Otherwise, this method does nothing.
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 186 def encoding @connection.encoding.to_s end
Returns the current database encoding format as a string, eg: 'UTF-8'
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 217
def explain(arel, binds = [])
sql = "EXPLAIN QUERY PLAN #{to_sql(arel, binds)}"
SQLite3::ExplainPrettyPrinter.new.pp(exec_query(sql, "EXPLAIN", []))
end # File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 304
def foreign_keys(table_name)
fk_info = exec_query("PRAGMA foreign_key_list(#{quote(table_name)})", "SCHEMA")
fk_info.map do |row|
options = {
column: row["from"],
primary_key: row["to"],
on_delete: extract_foreign_key_action(row["on_delete"]),
on_update: extract_foreign_key_action(row["on_update"])
}
ForeignKeyDefinition.new(table_name, row["table"], options)
end
end # File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 158 def reconnect! super connect if @connection.closed? end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 238
def rename_table(table_name, new_name)
exec_query "ALTER TABLE #{quote_table_name(table_name)} RENAME TO #{quote_table_name(new_name)}"
rename_table_indexes(table_name, new_name)
end Renames a table.
Example:
rename_table('octopuses', 'octopi')
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 127 def requires_reloading? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 139 def supports_datetime_with_precision? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 111 def supports_ddl_transactions? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 190 def supports_explain? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 123 def supports_expression_index? database_version >= "3.9.0" end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 131 def supports_foreign_keys? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 170 def supports_index_sort_order? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 147 def supports_insert_on_conflict? database_version >= "3.24.0" end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 143 def supports_json? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 194 def supports_lazy_transactions? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 119 def supports_partial_index? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 115 def supports_savepoints? true end
# File activerecord/lib/active_record/connection_adapters/sqlite3_adapter.rb, line 135 def supports_views? true end
© 2004–2019 David Heinemeier Hansson
Licensed under the MIT License.