Nivel inicial5 min de lectura · Publicado el

CRUD desde consola en Ruby on Rails

CRUD desde la consola de Rails: en el mostrador de una biblioteca, create da de alta un libro, find(1) lo pide, update corrige la ficha y destroy lo retira. CRUD sin salir de la consolarubentejera.com 1createfind(1)updatedestroy
La consola es el mostrador de la biblioteca: create da de alta un libro, find(1) lo pide por su número, update corrige su ficha y destroy lo retira, todo sin pasar por la web.

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 runner en una aplicación nueva de Rails 8.1.4.1 y Ruby 3.4.12 (imagen Docker ruby: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).