PostgreSQL 40001: no se pudo serializar el acceso
Bajo REPEATABLE READ o SERIALIZABLE, una transacción concurrente cambió datos de los que depende esta. PostgreSQL la revirtió; reintenta toda la transacción.
- SQLSTATE
40001- Nombre
serialization_failure- Categoría
- Reversión de transacción
Qué significa
Los niveles de aislamiento más altos de PostgreSQL prometen que una transacción ve una instantánea coherente. Cuando cumplir esa promesa es imposible porque otra transacción confirmó un cambio conflictivo, PostgreSQL aborta una de ellas con 40001 en lugar de devolver un resultado que no podría ocurrir en un orden serial.
Los mensajes varían según la causa: could not serialize access due to concurrent update o concurrent delete (una fila que intentaste cambiar fue modificada por otra persona después de tu instantánea), y could not serialize access due to read/write dependencies among transactions (SERIALIZABLE detectó un patrón peligroso). La solución es la misma: ejecutar la transacción de nuevo desde el principio.
Causas comunes
- Dos
REPEATABLE READoSERIALIZABLElas transacciones actualizan la misma fila; la segunda que intenta confirmar falla. - A
SERIALIZABLEla transacción lee filas que otra transacción luego cambió, en un patrón que podría producir una anomalía. - Filas calientes, como un contador o un saldo, actualizadas por muchas transacciones serializables concurrentes.
Cómo solucionarlo
-
Reintentar. El código que utiliza
REPEATABLE READoSERIALIZABLEdebe capturar SQLSTATE40001y volver a ejecutar toda la transacción, lecturas incluidas, varias veces con una breve pausa entre intentos. -
Mantén cortas las transacciones serializables y que afecten al menor número de filas posible.
-
Si no necesitas serializabilidad para este trabajo, el nivel predeterminado
READ COMMITTEDvuelve a leer la última versión de la fila al actualizar en lugar de fallar.BEGIN ISOLATION LEVEL READ COMMITTED; UPDATE counters SET n = n + 1 WHERE name = 'visits'; COMMIT;
-
Bajo
SERIALIZABLE, declara las transacciones de solo lectura como tales;SERIALIZABLE READ ONLY DEFERRABLEnunca falla con un error de serialización.BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;
Reprodúcelo de forma segura
Ejecuta en dos conexiones separadas en una base de datos de prueba.
-- Session 1: CREATE TABLE acct (id int PRIMARY KEY, bal int); INSERT INTO acct VALUES (1, 100); BEGIN ISOLATION LEVEL REPEATABLE READ; SELECT bal FROM acct WHERE id = 1; -- Session 2: UPDATE acct SET bal = 50 WHERE id = 1; -- Session 1: UPDATE acct SET bal = bal - 10 WHERE id = 1; -- ERROR: could not serialize access due to concurrent update ROLLBACK;
Errores relacionados
40P01se detectó un interbloqueo25P02la transacción actual está abortada55P03bloqueo no disponible3960SQL Server: Conflicto de actualización con aislamiento por instantáneaORA-08177Oracle: no se puede serializar el acceso para esta transacción1213MySQL: interbloqueo detectado al intentar obtener un bloqueo
El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.
Trabajar con PostgreSQL en SQLly
Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.