Well it certainly is the case that you learn something new every day. After digging into some confusion around how Rails chooses its data types I ended up turning to the API docs. From the API docs:
:limit – Requests a maximum column length. This is number of characters for :string and :text columns and number of bytes for :binary and :integer columns.
:limit => 11 would give us 11 characters in a string column, but I was trying to apply it to an integer. As they said in the docs, when you use :limit with an integer it means the number of bytes. So, for the sake of my own mental clarity here is what you should get when you use the :limit option:
|:limit => 1||
||1 byte||-128 to 127|
|:limit => 2||
||2 bytes||-32768 to +32767|
|:limit => 3||
||3 bytes||-8388608 to 8388607|
|:limit => 4||
||4 bytes||-2147483648 to +2147483647|
|:limit => 8||
||8 bytes||-9223372036854775808 to 9223372036854775807|
I say “should” above because Rails will take the value you give it and map that as best it can to whatever the actual database you are using can provide. So for MySQL it will give you a bigint for any :limit value between 5 and 8. One strange thing is that :limit => 11 maps to a 4 byte int(11) in MySQL. Not sure what thats about. For values that fall outside those, well, I guess I’ll figure that out another day.