Nivel inicial5 min de lectura · Publicado el

Consola de Ruby on Rails: rails console y consultas

Consola de Ruby on Rails: la web llega a Course por navegador, ruta y controlador; bin/rails c llega directo con Course.first. Rails console: sin navegadorrubentejera.com Coursenavegadorrutacontrolador$ bin/rails c> Course.first
Desde la web, una petición pasa por la ruta y el controlador antes de llegar al modelo Course y a su vista. Con bin/rails c te saltas ese camino: escribes Course.first y hablas con el modelo y la base de datos.

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

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.