Saltar al contenido
SQLCODE

SQLCODE -803Llave duplicada

Intentaste insertar o actualizar un renglón con una llave que ya existe en un índice único. Db2 lo rechaza para no tener dos renglones iguales.

¿Por qué pasa?

Una tabla puede tener columnas que no se repiten: la llave primaria o cualquier índice definido como único. Si un INSERT o un UPDATE deja dos renglones con el mismo valor en esas columnas, Db2 lo rechaza con -803 (SQLSTATE 23505).

Las causas de siempre:

  • Reproceso. El job falló a la mitad, se relanzó desde el principio y vuelve a insertar lo que ya había insertado.
  • Entrada con repetidos. El archivo trae el mismo registro dos veces.
  • Llave mal armada. Se generó una llave que ya existía, por ejemplo con un consecutivo que no se actualizó.

Ejemplo que lo provoca

           EXEC SQL
              INSERT INTO CLIENTE (ID_CLIENTE, NOMBRE)
                   VALUES (:WS-ID-CLIENTE, :WS-NOMBRE)
           END-EXEC

Si ID_CLIENTE es la llave primaria y ese cliente ya existe, sale -803.

Cómo resolverlo

  1. El mensaje del -803 dice qué índice reclamó. Así sabes qué columnas forman la llave repetida.
  2. Busca en la tabla el renglón que ya existe con esos valores.
  3. Decide qué hacer: ¿el registro ya estaba procesado y se puede saltar? ¿Debía actualizarse en lugar de insertarse? ¿La llave está mal armada?

Cómo evitarlo

  • Si “ya existe” es un caso normal, trátalo como tal:
           EVALUATE SQLCODE
              WHEN 0
                 ADD 1 TO WS-INSERTADOS
              WHEN -803
                 ADD 1 TO WS-YA-EXISTIAN
              WHEN OTHER
                 PERFORM 9999-ERROR-DB2
           END-EVALUATE
  • Si el registro puede venir nuevo o existente, considera MERGE, o un UPDATE que caiga en INSERT cuando dé SQLCODE 100.
  • Diseña los jobs para que se puedan relanzar sin duplicar: con puntos de reinicio o borrando lo que dejó la corrida fallida.