¿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
| Palabra | Qué significa |
|---|---|
| Transacción | cambios que una base de datos hace todos juntos o ninguno |
| Saga | un flujo que deshace sus pasos terminados cuando uno falla |
| Compensación | una acción que deshace un paso |
| Más reciente primero | el orden inverso al que se ejecutaron los pasos |
| Irreversible | imposible 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
docker exec worker python3 saga.py trip-1 --freshSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Reserva un viaje cuyo coche falla
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_carSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Lee las reservas de trip-2
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
docker exec worker python3 saga.py trip-3 --fresh --fail-at book_car --crash-after 3Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Reanuda trip-3 hasta sus compensaciones
docker exec worker python3 saga.py trip-3 --fail-at book_carSe 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
| Seq | Paso | Resultado | Escrito en la ejecución |
|---|---|---|---|
| 0 | book_flight | vuelo reservado | 1 |
| 1 | book_hotel | hotel reservado | 1 |
| 2 | book_car | fallo: no queda coche | 1 |
| 3 | cancel_hotel | hotel cancelado | 2 |
| 4 | cancel_flight | vuelo cancelado | 2 |
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
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.