Skip to content

Rails plugin for a database-independent dump format, data.yml.

Notifications You must be signed in to change notification settings

leomayleomay/yaml_db

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

= YamlDb

YamlDb is a database-independent format for dumping and restoring data.  It complements the the database-independent schema format found in db/schema.rb.  The data is saved into db/data.yml.

This can be used as a replacement for mysqldump or pg_dump, but only for the databases typically used by Rails apps.  Users, permissions, schemas, triggers, and other advanced database features are not supported - by design.

Any database that has an ActiveRecord adapter should work.

== Usage

rake db:data:dump [TABLE=xxx]  ->  Dump contents of Rails database to db/data.yml, you can specify the table you want to dump by providing the TABLE option, if it's a bunch of tables you want to dump, specify the table names separated by comma.
rake db:data:load              ->  Load contents of db/data.yml into the database

Further, there are tasks db:dump and db:load which do the entire database (the equivalent of running db:schema:dump followed by db:data:load).

== Examples

=== Dump all the tables in MySQL, and load the data to another database backend.

One common use would be to switch your data from one database backend to another.  For example, let's say you wanted to switch from SQLite to MySQL.  You might execute the following steps:

1. rake db:dump

2. Edit config/database.yml and change your adapter to mysql, set up database params

3. rake db:drop; rake db:create; rake db:migrate

4. rake db:load

=== Dump the specified table but all tables in the database.

1. rake db:dump TABLE=users

=== Dump several tables at one time

1. rake db:dump TABLE=users,profiles

== Credits

Created by Orion Henry and Adam Wiggins.  Major updates by Ricardo Chimal, Jr.

Patches contributed by Michael Irwin, Tom Locke, and Tim Galeckas.

Send questions, feedback, or patches to the Heroku mailing list: http://groups.google.com/group/heroku

About

Rails plugin for a database-independent dump format, data.yml.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 100.0%