DocumentaciónKCS de Experience Cloud

ID de incremento no secuenciales para pedidos en Adobe Commerce Cloud

Última actualización: 22 de junio de 2026

En Adobe Commerce Cloud Pro, los ID de incremento de pedidos, facturas, envíos y otras entidades aumentan en pasos como 100000001 → 100000004 → 100000007 en lugar de incrementarse en 1. Este comportamiento se produce debido a la arquitectura de base de datos de varios nodos de Galera utilizada en entornos Cloud Pro. Para solucionarlo, trate los ID de incremento únicamente como identificadores únicos y evite depender de la numeración secuencial.

Descripción description

Entorno

Adobe Commerce en Cloud Pro con MySQL de varios nodos (clúster de Galera)

Problema/Síntomas

Los comerciantes observan ese incremento en los ID:

  • Aumento en pasos (normalmente +3)
  • No siga una secuencia estricta
  • Omitir valores

Estos comportamientos plantean preocupaciones acerca de:

  • Números de pedido del cliente
  • Informes internos
  • Requisitos de auditoría y cumplimiento

Causa

Los entornos Cloud Pro utilizan un clúster Galera de 3 nodos para admitir una alta disponibilidad y coherencia de los datos.
Para evitar conflictos de claves principales durante escrituras simultáneas, MySQL utiliza la siguiente configuración:

  • auto_increment_increment = 3
  • auto_increment_offset = {1,2,3}(por nodo)

Cada nodo genera ID de forma independiente en su propia secuencia. Por ejemplo:

  • Nodo 1 → 1, 4, 7, 10…
  • Nodo 2 → 2, 5, 8, 11…
  • Nodo 3 → 3, 6, 9, 12…

Como resultado, los ID de incremento son:

  • Único globalmente
  • No secuencial cuando se ve como un flujo único

Comportamiento esperado

  • No se garantiza que los ID de incremento sigan una secuencia.
  • Las brechas y los aumentos de escalón son normales.
  • Este comportamiento se aplica a todas las entidades que utilizan incremento automático.

Este comportamiento también se produce fuera de los entornos agrupados debido a lo siguiente:

  • Transacciones fallidas
  • Reversiones
  • Operaciones simultáneas

Impacto

  • La funcionalidad del sistema y la integridad de los datos no se ven afectadas.
  • Los ID siguen siendo únicos y válidos para todas las operaciones de Adobe Commerce Cloud.
  • Solo se ven afectadas las expectativas de numeración secuencial.

Resolución resolution

Para resolver este problema, siga estos pasos:

  1. Evite depender de ID de incremento secuenciales.

    • Tratar los ID de incremento como identificadores únicos, no como valores ordenados.

    • Para pedidos e informes, utilice:

      • created_at marcas de tiempo
      • Relaciones de entidad o lógica empresarial

  2. Actualizar las herramientas de informes y auditoría.

    • Si las herramientas esperan una secuencia estricta:

      • Actualice la lógica para gestionar ID no contiguos.
      • Elimine las dependencias de la continuidad numérica.

  3. Implemente una secuencia personalizada (si es necesario).

    • Si su empresa requiere números secuenciales estrictos:

      • Cree un generador de secuencias personalizado (por ejemplo, un módulo personalizado).
      • Almacene el valor como un atributo independiente (no reemplace el ID de incremento).
      • Utilice un bloqueo adecuado para evitar condiciones de carrera.

Práctica recomendada

Trate los ID de incremento como placas de matrícula, no como contadores de tickets:

  • Identifican los elementos de forma exclusiva
  • No garantizan el orden

Conclusión

Los ID de incremento no secuenciales en Cloud Pro son un resultado directo del diseño de la base de datos distribuida de la plataforma. Esto garantiza la escalabilidad y la fiabilidad, pero significa que no se admite la secuenciación estricta en el nivel de infraestructura. Para los casos de uso que requieren numeración secuencial, se requiere una solución personalizada o externa.

Lectura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles