#lol_dba [![travis](https://api.travis-ci.org/plentz/lol_dba.png?branch=master)](https://travis-ci.org/plentz/lol_dba)

lol_dba is a small package of rake tasks that scan your application models and displays a list of columns that probably should be indexed. Also, it can generate .sql migration scripts. Most of the initial code came from [rails_indexes](https://github.com/warpc/rails_indexes) and [migration_sql_generator](https://github.com/muness/migration_sql_generator).

### Quick example

To use lol_dba in the easiest way possible you have to do two things:

	gem install lol_dba

Then run one of the following commands...

To display a migration for adding/removing all necessary indexes based on associations:

	lol_dba db:find_indexes

To generate .sql files for your migrations inside db/migrate_sql folder:

	lol_dba db:migrate_sql # defaults to all migrations
	lol_dba db:migrate_sql[pending] # only pending migrations
	lol_dba db:migrate_sql[20120221205526] # generate sql only for migration 20120221205526

### Not-so-quick example

If you want to use lol_dba with rake, you should do a few more steps:

Add lol_dba to your Gemfile

    gem "lol_dba"

Run the install command

    bundle install

Use it the same way you use other rake commands

	rake db:find_indexes
	rake db:migrate_sql # defaults to all migrations
	rake db:migrate_sql[pending] # only pending migrations
	rake db:migrate_sql[20120221205526] # generate sql only for migration 20120221205526

### Compatibility

Compatible with Ruby 2.x and Rails 3.x, 4.x, 5.x.

### About primary_key

>The primary key is always indexed. This is generally true for all storage engines that at all supports indices.

For this reason, we no longer suggest to add indexes to primary keys.

### Tests

To run lol_dba tests, just clone the repo and run:

    bundle install && rake

to run the tests.

### Feedback

All feedback, bug reports and thoughts on this gratefully received.

### Contributors

* [Diego Plentz](http://plentz.org)
* [Elad Meidar](http://blog.eizesus.com)
* [Eric Davis](http://littlestreamsoftware.com)
* [Jay Fields](http://jayfields.com/)
* [Muness Alrubaie](http://muness.blogspot.com/)
* [Vladimir Sharshov](https://github.com/warpc)
* [Fabio Rehm](http://fabiorehm.com/)
* [Emanuel Imhof](http://m43nu.ch)
* [Adrian Hooper](https://twitter.com/PaReeOhNos)
* [Ray Zane](https://github.com/rzane)
* [Grant Gongaware](https://github.com/ggongaware)
* [Przemysław “Szeryf” Kowalczyk](https://szeryf.wordpress.com)
* [Philipp Weissensteiner](http://philippweissensteiner.com)
* [Leung Ho Kuen](https://twitter.com/PikachuEXE)
* [Lucas Mazza](https://twitter.com/lucasmazza)
* [Larry Reaves](https://github.com/yrral86)
* [James Bowles](https://github.com/jamesbowles)

### License

Lol DBA is released under the MIT license.