Documentation Commerce Data Export Guide pour les services SaaS

Référence de l’interface de ligne de commande de l’exportation de données SaaS

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Administration

Les développeurs et les administrateurs système peuvent gérer les opérations de synchronisation pour l’exportation des données SaaS à l’aide de l’ outil de ligne de commande Adobe Commerce (interface de ligne de commande). La commande saas:resync est incluse dans le package magento/saas-export.

Adobe ne recommande pas d'utiliser régulièrement la commande saas:resync. Les scénarios types d’utilisation de la commande sont les suivants :

Synchronisation initiale
L’ identifiant de l’espace de données SaaS a été modifié et vous devez synchroniser les données dans le nouvel espace de données.
Dépannage

Synchronisation initiale

NOTE

Si vous utilisez la recherche en direct ou le Recommendations de produit, il n’est pas nécessaire d’exécuter la synchronisation initiale. Le processus est lancé automatiquement une fois que vous avez connecté le service à votre instance Commerce.

Lorsque vous déclenchez un saas:resync à partir de la ligne de commande, selon la taille de votre catalogue, la mise à jour des données peut prendre de quelques minutes à quelques heures.

Pour la synchronisation initiale, Adobe recommande d’exécuter les commandes dans l’ordre suivant :

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

Exemples de commandes

Avant d’utiliser des commandes saas:resync, passez en revue les descriptions d’option.

Effectuez une resynchronisation complète pour un flux d’entité.

code language-none
`bin/magento saas:resync --feed='<FEED_NAME>' 1`

Les flux qui ont déjà été exportés avec succès ne sont pas resynchronisés.

Resynchronisation complète des données de nettoyage et de flux spécifiées

code language-none
`bin/magento saas:resync --feed='FEED_NAME' --cleanup-feed`

Utilisez uniquement après avoir effectué une opération Data Space ID Cleanup.

Pour les flux d’exportation immédiats, renvoyez toutes les données aux services Commerce connectés sans tronquer les données d’index dans la table des flux.

code language-none
`bin/magento saas:resync --feed='FEED_NAME' --no-reindex`

Liste des commandes et options disponibles avec des descriptions.

code language-none
`bin/magento saas:resync --help`

Options de commande

Les options suivantes sont disponibles pour la gestion des opérations saas:resync.

NOTE

La commande saas:resync prend également en charge des options avancées pour améliorer les commandes d’exportation de données en augmentant la taille du lot et en ajoutant un traitement multithread. Voir Personnalisation du traitement de l’exportation.

`feed`

Cette option obligatoire spécifie l’entité de flux à resynchroniser, telle que products.

La valeur de l’option feed peut inclure n’importe quel flux d’entité disponible :

products : flux de données de produit
productAttributes : flux de données des attributs de produit
categories : flux de données de catégories
variants : flux de données de variantes de produits configurables
prices : flux de données sur les prix des produits
categoryPermissions : flux de données des autorisations de catégorie
productOverrides : flux de données des autorisations de produit
inventoryStockStatus : flux de données d’état du stock
scopesWebsite : sites web avec des magasins et des flux de données de vues de magasin
scopesCustomerGroup : flux de données de groupes de clients
orders : flux de données des commandes client

Selon les services Commerce installés, un autre ensemble de flux peut être disponible pour la commande saas:resync.

`no-reindex`

Cette option réenvoie les données de catalogue existantes vers Commerce Services sans réindexation. Si cette option n’est pas spécifiée, la commande exécute une réindexation complète avant de synchroniser les données.

Le comportement de cette option dépend de l’exportation ou non du flux en mode d’exportation hérité ou immédiat

Pour les flux d’exportation hérités, le processus de synchronisation ne tronque pas les données indexées dans la table des flux. Au lieu de cela, il envoie toutes les données au service Adobe Commerce.
Pour les flux d’exportation immédiats, cette option est ignorée si elle est spécifiée. Pour ces flux, le processus de resynchronisation ne tronque pas l’index et ne resynchronise que les mises à jour ou les éléments qui avaient précédemment échoué.

`cleanup`

Cette option nettoie la table de l’indexeur de flux avant une synchronisation. Lorsqu’elle est spécifiée, l’exportation des données SaaS exécute une resynchronisation complète pour le flux spécifié et nettoie toutes les données existantes dans le tableau du flux.

Adobe recommande de n'utiliser cette commande qu'après avoir effectué l'opération Data Space ID Cleanup.

WARNING

N’utilisez pas cette option régulièrement. Cela peut entraîner des problèmes de synchronisation des données dans les services Adobe Commerce. Par exemple, le delete product event peut ne pas se propager au service Adobe Commerce si l’option cleanup est utilisée.

Dépannage

Si vous ne voyez pas les données attendues dans les services Commerce connectés, résolvez les problèmes en vérifiant les journaux d’erreurs d’exportation des données et en utilisant la commande saas:resync avec des variables d’environnement pour examiner les payloads et les données du profileur. Voir Journaux des révisions et dépannage.

recommendation-more-help

6183eb5c-cb5c-49fa-bd7b-cd38576b727c