[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Modifier l'ID incrément d'une entité de base de données (commande, facture, avoir, etc.) dans un magasin particulier

Cet article explique comment modifier l’ID d’incrément d’une entité de base de données (DB) Adobe Commerce (commande, facture, avoir, etc.) sur une boutique Adobe Commerce spécifique à l’aide de l’instruction SQL ALTER TABLE.

Versions affectées

  • Adobe Commerce on-premise : 2.x.x
  • Adobe Commerce sur l’infrastructure cloud : 2.x.x
  • MySQL : toute version prise en charge

Quand devez-vous modifier l’ID d’incrément (cas) ?

Vous devrez peut-être modifier l’ID d’incrément pour les nouvelles entités de base de données dans les cas suivants :

  • Après une restauration par sauvegarde irréversible sur un site actif
  • Certains enregistrements de commande ont été perdus, mais leurs identifiants sont déjà utilisés par les passerelles de paiement (comme PayPal) pour votre compte marchand actuel. Dans ce cas, les passerelles de paiement arrêtent le traitement des nouvelles commandes ayant les mêmes ID, renvoyant l'erreur « ID de facture en double »
NOTE
Vous pouvez également résoudre le problème de passerelle de paiement pour PayPal en autorisant plusieurs paiements par ID de facture dans les Préférences de réception des paiements de PayPal. Voir Demande rejetée de la passerelle PayPal - problème de facture en double dans notre base de connaissances du support.

Étapes préalables

  1. Recherchez les magasins et les entités pour lesquels le nouvel ID d’incrément doit être modifié.
  2. Connexion à votre base de données MySQL. Pour Adobe Commerce sur les infrastructures cloud, vous devez d’abord SSH à votre environnement.
  3. Vérifiez la valeur auto_increment actuelle pour la table de séquences d'entités à l'aide de la requête suivante :
SHOW TABLE STATUS FROM `{database_name}` WHERE `name` LIKE 'sequence_{entity_type}_{store_id}';

Exemple

Si vous vérifiez une incrémentation automatique pour une commande sur le magasin avec l’ID=1, le nom de la table serait :

'sequence_order_1'

Si la valeur de la colonne auto_increment est 1234, la commande suivante passée dans le magasin avec ID=1 aura le ID #100001234.

Documentation connexe

Mettre à jour l’entité pour modifier l’ID d’incrément

Mettez à jour l'entité à l'aide de la requête suivante :

ALTER TABLE sequence_{entity_type}_{store_id} AUTO_INCREMENT = {new_increment_value};
WARNING
Important : la nouvelle valeur d’incrément doit être supérieure à la valeur actuelle, et non inférieure.

Exemple

Après avoir exécuté la requête suivante :

ALTER TABLE sequence_order_1 AUTO_INCREMENT = 2000;

la prochaine commande passée dans le magasin avec ID=1 aura le ID #100002000.

Étapes supplémentaires recommandées dans l’environnement de production (cloud)

Avant d’exécuter la requête ALTER TABLE sur l’environnement de production d’Adobe Commerce sur l’infrastructure cloud, nous vous recommandons vivement d’effectuer les étapes suivantes :

  • Tester l’ensemble de la procédure de modification de l’ID d’incrément dans votre environnement d’évaluation
  • Créer une sauvegarde de base de données pour restaurer votre base de données de production en cas d’échec

Documentation connexe

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a