Sincronizzare i feed utilizzando Commerce CLI
Creato per:
- Amministratore
Il comando saas:resync
nel pacchetto magento/saas-export
consente di gestire la sincronizzazione dei dati per i servizi SaaS di Adobe Commerce.
Adobe sconsiglia di utilizzare il comando saas:resync
regolarmente. Gli scenari tipici per l’utilizzo del comando sono:
- Sincronizzazione iniziale
- Sincronizza i dati con un nuovo spazio dati dopo aver modificato l'ID spazio dati SaaS
- Risoluzione dei problemi
Monitorare le operazioni di sincronizzazione nel file var/log/saas-export.log
.
Sincronizzazione iniziale
Quando si attiva un saas:resync
dalla riga di comando, a seconda delle dimensioni del catalogo, l'aggiornamento dei dati può richiedere da alcuni minuti ad alcune ore.
Per la Sincronizzazione iniziale, Adobe Systems consiglia di eseguire i comandi nell'ordine seguente:
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
Sincronizzazione tramite comandi CLI
Il comando saas:resync
supporta diverse operazioni di sincronizzazione:
- Sincronizzazione parziale con SKU
- Riprendi sincronizzazioni interrotte
- Convalida dei dati senza sincronizzazione
Visualizza tutte le opzioni disponibili:
bin/magento saas:resync --help
Per la descrizione delle opzioni con esempi, consulta le sezioni seguenti.
--by-ids
Risincronizza parzialmente entità specifiche in base ai loro ID. Supporta products
, productAttributes
, productOverrides
, inventoryStockStatus
, prices
, variants
e categoryPermissions
feed.
Per impostazione predefinita, quando si utilizza l'opzione --by-ids
si specificano valori utilizzando i valori SKU del prodotto. Per utilizzare gli ID prodotto, aggiungere l'opzione --id-type=ProductID
.
Esempi:
bin/magento saas:resync --feed products --by-ids='ADB102,ADB111,ADB112'
bin/magento saas:resync --feed= products --by-ids='1,2,3' --id-type='productId'
--cleanup-feed
Pulisci la tabella dell’indicizzatore del feed prima della reindicizzazione e dell’invio dei dati a SaaS. Supportato solo per products
, productAttributes
, productOverrides
, inventoryStockStatus
, prices
, variants
e categoryPermissions
.
Se utilizzata con l'opzione --dry-run
, l'operazione esegue un'operazione di risincronizzazione a secco per tutti gli elementi.
--dry-run
. Se utilizzata in altri casi, l’operazione di pulizia può causare la perdita di dati e problemi di sincronizzazione dei dati.Esempio:
bin/magento saas:resync --feed products --cleanup-feed
--continue-resync
Riprende un'operazione di risincronizzazione interrotta. Supportato solo per products
, productAttributes
e productOverrides
feed.
Esempio:
bin/magento saas:resync --feed productAttributes --continue-resync
--dry-run
Esegue il processo di reindicizzazione feed senza inviare il feed a SaaS e senza salvare nella tabella feed. Questa opzione è utile per identificare eventuali problemi con il set di dati.
Aggiungi la variabile di ambiente in cui salvare il EXPORTER_EXTENDED_LOG=1
payload var/log/saas-export.log
.
Esempio:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run
Verifica elementi di feed specifici
Verificare elementi di feed specifici aggiungendo l'opzione --by-ids
con la raccolta di registri estesi per visualizzare il payload generato nel file var/log/saas-export.log
.
Esempio:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'
Test di tutti gli elementi feed
Per impostazione predefinita, il feed inviato durante un'operazione resync --dry-run
include solo i nuovi elementi o gli elementi che non è stato possibile esportare in precedenza. Per includere tutti gli elementi nel feed da elaborare, utilizzare l'opzione --cleanup-feed
.
Esempio
bin/magento saas:resync --feed products --dry-run --cleanup-feed
--feed
Obbligatorio. Specifica l'entità feed da risincronizzare.
Feed disponibili:
categories
categoryPermissions
inventoryStockStatus
orders
prices
products
productAttributes
productOverrides
scopesWebsite
scopesCustomerGroup
variants
Esempio:
bin/magento saas:resync --feed products
--no-reindex
Invia nuovamente i dati del catalogo esistenti a Commerce Services senza reindicizzazione. Non supportato per feed relativi a prodotti.
Il comportamento varia in base alla modalità di esportazione:
- Modalità legacy: invia di nuovo tutti i dati senza troncare.
- Modalità immediata: l'opzione viene ignorata, sincronizza solo gli aggiornamenti/errori.
Esempio:
bin/magento saas:resync --feed productAttributes --no-reindex
--id-type=ProductId
Per impostazione predefinita, le entità specificate quando si utilizza il saas:resync feed
comando con l'opzione --by-ids
sono specificate dal referenza di magazzino di prodotto. Utilizzare l'opzione --id-type=ProductId
per specificare le entità in base all'ID prodotto.
bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'
Esempio:
Risoluzione dei problemi
Se non vengono visualizzati i dati previsti nei servizi Commerce connessi, risolvere i problemi verificando i registri degli errori di esportazione dei dati e utilizzando il comando saas:resync
con variabili di ambiente per rivedere i payload e i dati del profiler. Consulta Esaminare i registri e risolvere i problemi.