Documentazione Commerce Data Export Guida per i servizi SaaS

Riferimento all'interfaccia della riga di comando per l'esportazione di dati SaaS

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

Argomenti:

Creato per:

Amministratore

Gli sviluppatori e gli amministratori di sistema possono gestire le operazioni di sincronizzazione per l'esportazione di dati SaaS utilizzando lo strumento da riga di comando Adobe Commerce (CLI). Il comando saas:resync è incluso nel pacchetto magento/saas-export.

L'Adobe sconsiglia di utilizzare il comando saas:resync regolarmente. Gli scenari tipici per l’utilizzo del comando sono:

Sincronizzazione iniziale
L'ID dello spazio dati SaaS è stato modificato ed è necessario sincronizzare i dati con il nuovo spazio dati.
Risoluzione dei problemi

Sincronizzazione iniziale

NOTE

Se utilizzi Live Search o Product Recommendations, non è necessario eseguire la sincronizzazione iniziale. Il processo viene avviato automaticamente dopo la connessione del servizio all’istanza di Commerce.

Quando si attiva 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, l'Adobe 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

Esempi di comandi

Prima di utilizzare i comandi saas:resync, controlla le descrizioni delle opzioni.

Eseguire una risincronizzazione completa per un feed di entità.

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

I feed già esportati non vengono risincronizzati.

Risincronizzazione completa del feed specificato e dei dati di pulizia

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

Utilizzare solo dopo l'esecuzione di un'operazione Data Space ID Cleanup.

Per i feed di esportazione immediati, invia nuovamente tutti i dati ai servizi Commerce connessi senza troncare i dati di indice nella tabella dei feed

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

Elenca i comandi e le opzioni disponibili con le relative descrizioni.

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

Opzioni di comando

Le opzioni seguenti sono disponibili per la gestione di saas:resync operazioni.

NOTE

Il comando saas:resync supporta inoltre opzioni avanzate per migliorare i comandi di esportazione dei dati aumentando le dimensioni del batch e aggiungendo l'elaborazione multi-thread. Vedi Personalizzare l'elaborazione dell'esportazione.

`feed`

Questa opzione obbligatoria specifica l'entità feed da risincronizzare, ad esempio products.

Il valore dell'opzione feed può includere qualsiasi feed di entità disponibile:

products: feed dati prodotto
productAttributes: feed dati attributi prodotto
categories: feed dati categorie
variants: feed dati varianti prodotto configurabili
prices: feed dati prezzi prodotto
categoryPermissions: feed dati per autorizzazioni categoria
productOverrides: feed dati delle autorizzazioni del prodotto
inventoryStockStatus: feed dati stato scorte
scopesWebsite: siti Web con feed di dati di visualizzazioni store e store
scopesCustomerGroup: feed dati per gruppi di clienti
orders: feed dati ordini cliente

A seconda dei Servizi Commerce installati, è possibile che sia disponibile un diverso set di feed per il comando saas:resync.

`no-reindex`

Questa opzione invia nuovamente i dati del catalogo esistenti a Commerce Services senza reindicizzazione. Se questa opzione non è specificata, il comando esegue una reindicizzazione completa prima di sincronizzare i dati.

Il comportamento di questa opzione dipende dal fatto che il feed sia esportato in modalità di esportazione legacy o immediata

Per i feed di esportazione legacy, il processo di sincronizzazione non tronca i dati indicizzati nella tabella dei feed. Al contrario, invia nuovamente tutti i dati al servizio Adobe Commerce.
Per i feed di esportazione immediati, questa opzione viene ignorata se specificata. Per questi feed, il processo di risincronizzazione non troncerà l'indice e risincronizza solo gli aggiornamenti o gli elementi con errori precedenti.

`cleanup`

Questa opzione consente di pulire la tabella dell’indicizzatore del feed prima di una sincronizzazione. Se specificato, l'esportazione dei dati SaaS esegue una risincronizzazione completa per il feed specificato e pulisce tutti i dati esistenti nella tabella dei feed.

L'Adobe consiglia di utilizzare questo comando solo dopo aver eseguito l'operazione Data Space ID Cleanup.

WARNING

Non utilizzare questa opzione regolarmente. Può causare problemi di sincronizzazione dei dati nei servizi Adobe Commerce. delete product event potrebbe ad esempio non propagarsi al servizio Adobe Commerce se si utilizza l'opzione cleanup.

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.

recommendation-more-help

6183eb5c-cb5c-49fa-bd7b-cd38576b727c