CRUD desde consola en Ruby on Rails
CRUD son las cuatro operaciones básicas con datos: Create (crear), Read (leer), Update (actualizar) y Delete (borrar). En Rails las haces con Active Record, la capa que traduce tus objetos de Ruby a filas de la base de datos.
La consola de Rails es como el mostrador de una biblioteca: pides un libro por su número (find), buscas por autor (where), das de alta uno nuevo (create) o lo retiras (destroy), sin pasar por la web.
Los ejemplos usan un modelo Course con un campo title. Si aún no tienes uno, mira cómo crear modelos en Ruby on Rails y cómo usar la consola de Ruby on Rails.
Read: consultar registros
| Método | Qué devuelve |
|---|---|
Course.all |
Todos los cursos |
Course.first |
El primero, ordenado por id |
Course.last |
El último, ordenado por id |
Course.find(1) |
El curso con ese id. Si no existe, lanza ActiveRecord::RecordNotFound |
Course.find_by(title: "Curso de Python") |
El primero que cumple la condición, o nil si no hay ninguno |
Course.where(id: 2) |
Todos los que cumplen el filtro (aunque sea uno, es una lista) |
Course.where(id: 1, title: "Curso de Ganchillo") |
Filtro con dos condiciones a la vez |
Course.exists?(2) |
true o false según exista |
Course.order(:title) |
Todos, ordenados por título |
Create: crear un registro
En dos pasos: primero creas el objeto en memoria y luego lo guardas.
course = Course.new
=> #<Course id: nil, title: nil, created_at: nil, updated_at: nil>
Le asignas un título:
course.title = "Curso desde Consola"
=> "Curso desde Consola"
El objeto ya tiene su título, pero todavía no está en la base de datos (su id sigue siendo nil):
course
=> #<Course id: nil, title: "Curso desde Consola", created_at: nil, updated_at: nil>
Para guardarlo:
course.save # => true si se guardó
En la consola de Rails 5.2, con dos cursos ya guardados, save lanza un INSERT dentro de una transacción, y el curso nuevo aparece con el id 3:
irb(main):011:0> Course.all
Course Load (0.3ms) 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">]>
irb(main):012:0> course.save
(0.2ms) begin transaction
Course Create (11.9ms) INSERT INTO "courses" ("title", "created_at", "updated_at") VALUES (?, ?, ?) [["title", "Curso desde Consola"], ["created_at", "2018-07-30 08:50:18.369849"], ["updated_at", "2018-07-30 08:50:18.369849"]]
(5.3ms) commit transaction
=> true
irb(main):013:0> Course.all
Course Load (0.4ms) 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">, #<Course id: 3, title: "Curso desde Consola", created_at: "2018-07-30 08:50:18", updated_at: "2018-07-30 08:50:18">]>
O en un solo paso, con create:
Course.create(title: "Curso desde Consola")
Update: actualizar un registro
Busca el registro, cambia lo que quieras y guarda:
course = Course.find(1)
course.title = "Curso de Macrame"
course.save
Al guardar, Rails lanza un UPDATE solo con los campos que han cambiado (salida de Rails 5.2):
(0.1ms) begin transaction
Course Update (0.3ms) UPDATE "courses" SET "title" = ?, "updated_at" = ? WHERE "courses"."id" = ? [["title", "Curso de Macrame"], ["updated_at", "2018-07-30 09:03:50.862759"], ["id", 1]]
(16.8ms) commit transaction
=> true
O en un solo paso, con update:
Course.find(1).update(title: "Curso de Macrame")
Delete: borrar un registro
course = Course.find(1)
course.destroy
destroy lanza un DELETE y devuelve el objeto borrado (salida de Rails 5.2):
(0.1ms) begin transaction
Course Destroy (0.4ms) DELETE FROM "courses" WHERE "courses"."id" = ? [["id", 1]]
(16.9ms) commit transaction
=> #<Course id: 1, title: "Curso de Macrame", created_at: "2018-07-27 08:10:57", updated_at: "2018-07-30 09:03:50">
Para borrar varios a la vez: Course.where(title: "Uno").destroy_all.
save y update devuelven false si algo falla: mira siempre la respuesta.
Fuentes
- Guías oficiales de Rails: Active Record Basics (CRUD) y Active Record Query Interface, y la API de QueryMethods, versión actual (el original enlazaba a la de Rails 5.1).
- Ejecutado el 7 de noviembre de 2026 con
bin/rails runneren una aplicación nueva de Rails 8.1.4.1 y Ruby 3.4.12 (imagen Dockerruby:3.4, SQLite): todos los métodos de este artículo y sus resultados. Las salidas de consola son de Rubén (Rails 5.2, 2018).