¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Sagas y compensación

Después de esta lección: Puedo calcular las compensaciones que debe ejecutar una saga que ha fallado.

Lección de 60 min5 comandosLaboratorio de ejecución duradera: haz caer un flujo a propósito y reanúdalo desde su diario

¿Qué es una saga en un flujo?

Una saga es un flujo cuyos pasos tienen cada uno una compensación, una acción que los deshace. Cuando un paso posterior falla, la saga ejecuta las compensaciones de los pasos terminados, del más reciente al más antiguo.

Así una reserva de viaje cancela el vuelo y el hotel cuando no queda coche, aunque tres empresas distintas tomaron las reservas.

Al final de esta lección

Nota

Puedo calcular las compensaciones que debe ejecutar una saga que ha fallado.

Palabras clave

PalabraQué significa
Transaccióncambios que una base de datos hace todos juntos o ninguno
Sagaun flujo que deshace sus pasos terminados cuando uno falla
Compensaciónuna acción que deshace un paso
Más reciente primeroel orden inverso al que se ejecutaron los pasos
Irreversibleimposible de deshacer, como un correo ya enviado

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Una transacción no cubre tres empresas

Dentro de una base de datos, una transacción hace varios cambios todos juntos o ninguno. Un viaje se reserva con una aerolínea, un hotel y una empresa de alquiler de coches. Cada una tiene su propio sistema, y ninguna entra en una transacción con las otras.

Así que cada reserva es un paso separado que ocurre de verdad. Si el coche falla, el vuelo y el hotel ya están reservados, y algo tiene que deshacerlos.

Reserva un viaje completo

Comando
docker exec worker python3 saga.py trip-1 --fresh

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Reserva un viaje cuyo coche falla

Comando
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_car

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lee las reservas de trip-2

Comando
docker exec db psql -U durable -c "SELECT item, status FROM bookings WHERE workflow = 'trip-2' ORDER BY id"

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Las compensaciones también son pasos

El motor escribe en el diario el paso que falló, con su motivo. Cada compensación es un paso normal, con su propia fila.

Así que una caída mientras se deshace es segura. Los siguientes Run hacen caer trip-3 justo después de que falle el coche. La reanudación repite las tres filas, ve el fallo y ejecuta las dos compensaciones. Una compensación nunca se olvida a medias.

Caída justo después de que falle el coche

Comando
docker exec worker python3 saga.py trip-3 --fresh --fail-at book_car --crash-after 3

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Reanuda trip-3 hasta sus compensaciones

Comando
docker exec worker python3 saga.py trip-3 --fail-at book_car

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo resuelto: el diario de trip-3

SeqPasoResultadoEscrito en la ejecución
0book_flightvuelo reservado1
1book_hotelhotel reservado1
2book_carfallo: no queda coche1
3cancel_hotelhotel cancelado2
4cancel_flightvuelo cancelado2

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un error frecuente

Advertencia

Mucha gente cree que una compensación deja el mundo exactamente como estaba. No puede desenviar un correo ni desimprimir un billete. Una compensación es una acción nueva, como un reembolso o una disculpa, y algunos pasos no tienen ninguna. Pon esos pasos al final.

Pruébalo: un paso que no se deshace

Código: python
STEPS = [["book_flight", "cancel_flight"],
         ["book_hotel", "cancel_hotel"],
         ["send_ticket", None],          # un correo no se puede desenviar
         ["book_car", "cancel_car"]]
FAILS = "book_car"

done = []
for pair in STEPS:
    if pair[0] == FAILS:
        print(pair[0], "falló")
        break
    print(pair[0], "ok")
    done.append(pair)

done.reverse()   # el más reciente primero
for pair in done:
    if pair[1] is None:
        print("no se puede deshacer", pair[0])
    else:
        print("compensar:", pair[1])
# Pon FAILS = "book_hotel" y vuelve a ejecutarlo.

Sobre este laboratorio y su código: Laboratorio de ejecución duradera: haz caer un flujo a propósito y reanúdalo desde su diario

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.