Consola de Ruby on Rails: rails console y consultas
La consola de Ruby on Rails es una sesión interactiva de Ruby (como irb) con tu aplicación ya cargada. Es como entrar en la cocina de un restaurante en vez de pedir desde la mesa: no pasas por la carta (las vistas y los controladores), tocas directamente los ingredientes (los modelos y la base de datos).
Sirve para probar consultas antes de escribirlas en el código, revisar datos o crear registros de prueba. Si lo que buscas es la consola de Ruby a secas, sin Rails, escribe irb en la terminal: viene con Ruby como gema por defecto (irb 1.14.3 en Ruby 3.4.12).
Abrir la consola de Rails: rails console
Desde la carpeta de tu proyecto:
bin/rails console # forma larga
bin/rails c # forma corta
Por defecto arranca en el entorno de desarrollo. Opciones útiles:
| Orden | Qué hace |
|---|---|
bin/rails c |
Abre la consola en desarrollo |
bin/rails c -e test |
La abre en otro entorno (test, production…) |
bin/rails c --sandbox |
Todo lo que cambies en la base de datos se deshace al salir |
reload! |
Dentro de la consola, recarga el código que hayas modificado |
exit |
Sale de la consola |
Así se veía en Rails 5.2, cuando la consola arrancaba a través de Spring:
ruby bin/rails console
Running via Spring preloader in process 11596
Loading development environment (Rails 5.2.0)
irb(main):001:0> Course.all
Course Load (0.6ms) SELECT "courses".* FROM "courses" LIMIT ? [["LIMIT", 11]]
=> #<ActiveRecord::Relation [#<Course id: 1, title: "Curso de Ganchillo", created_at: "2018-07-27 08:10:57", updated_at: "2018-07-27 08:10:57">, #<Course id: 2, title: "Curso de Python", created_at: "2018-07-27 08:26:48", updated_at: "2018-07-27 08:26:48">]>
En Rails 8 el mensaje es más corto, pero funciona igual.
Consultas desde la consola (Query Methods)
Los ejemplos usan un modelo Course con tres cursos. El nombre del modelo va en singular: Course.all, no Courses.all.
Buscar registros
| Consulta | Qué devuelve |
|---|---|
Course.all |
Todos los cursos |
Course.first |
El primero, ordenado por id |
Course.last |
El último, ordenado por id |
Course.find(2) |
El curso con id 2; si no existe, lanza ActiveRecord::RecordNotFound |
Course.find_by(title: "Curso de Ruby") |
El primero que cumple la condición, o nil si no hay ninguno |
Course.exists?(2) |
true o false |
Filtrar con where
Course.where(id: 2) # un filtro
Course.where(id: 1, title: "Curso de Ganchillo") # dos filtros (AND)
Course.where.not(id: 2) # todos menos el 2
Course.where("title LIKE ?", "%Curso%") # búsqueda parcial
Course.where("title LIKE ? OR id = ?", "%Ganch%", 2)
where no devuelve un curso, sino una relación: una lista que puedes seguir filtrando o recorrer. Si quieres ver la SQL que genera, añade .to_sql:
Course.where(id: 2).to_sql
# => SELECT "courses".* FROM "courses" WHERE "courses"."id" = 2
Si el modelo tiene asociaciones, también se recorren igual en la consola: por ejemplo, articulo.comentarios.
Prueba la consulta en la consola; después, llévala al modelo.
Cuando una consulta se repite, conviene darle nombre en el modelo con un scope; lo tienes en Scopes en Ruby on Rails. Y si quieres crear, editar y borrar registros desde la consola, sigue con CRUD desde consola en Ruby on Rails.
Fuentes
- The Rails Command Line: bin/rails console (guías de Rails 8.1).
- Active Record Query Interface (Rails 8.1.4.1):
find,find_by,where,where.not,exists?y condiciones con marcadores. - Securing Rails Applications: SQL Injection.
Todas las consultas se han ejecutado con Rails 8.1.4.1 y Ruby 4.0.9 (imagen oficial ruby:latest de Docker) sobre SQLite, con bin/rails runner. La sesión de Rails 5.2 es de Rubén.