Sincronizar feeds usando a CLI do Commerce
O comando saas:resync no pacote magento/saas-export permite gerenciar a sincronização de dados para serviços SaaS do Adobe Commerce.
A Adobe não recomenda usar o comando saas:resync regularmente. Os cenários típicos para usar o comando são:
- Sincronização inicial
- Sincronizar dados com um novo espaço de dados após alterar a ID do Espaço de Dados SaaS
- Solução de problemas
Monitorar operações de sincronização no arquivo var/log/saas-export.log.
Sincronização inicial
Quando você aciona um saas:resync na linha de comando, dependendo do tamanho do catálogo, pode levar de alguns minutos a algumas horas para que os dados sejam atualizados.
Para a sincronização inicial, a Adobe recomenda executar os comandos na seguinte ordem:
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
Sincronizar usando comandos CLI
O comando saas:resync dá suporte a várias operações de sincronização:
- Sincronização parcial por SKU
- Retomar sincronizações interrompidas
- Validar dados sem sincronização
Exibir todas as opções disponíveis:
bin/magento saas:resync --help
Consulte as seções a seguir para obter descrições de opções com exemplos.
--by-ids
Ressincronizar parcialmente entidades específicas por suas IDs. Suporta os feeds products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions.
Por padrão, ao usar a opção --by-ids, você especifica valores usando valores de SKU do produto. Para usar IDs de produto, adicione a opção --id-type=ProductID.
Exemplos:
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
Limpe a tabela indexadora de feed antes de reindexar e enviar dados para o SaaS. Com suporte somente para products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions.
Se usada com a opção --dry-run, a operação executará uma operação de ressincronização de simulação para todos os itens.
cleanup-feed limpa o estado de exportação do feed local e pode levar à sincronização incompleta. Por exemplo, as exclusões de entidade no Adobe Commerce podem não ser refletidas nos Serviços Commerce conectados, ou entidades obsoletas podem permanecer nos índices remotos dos Serviços Commerce mesmo que tenham sido excluídas ou atualizadas no Adobe Commerce. Use essa opção somente para recriações completas de ambiente, como após uma limpeza de espaço de dados SaaS.Exemplo:
bin/magento saas:resync --feed products --cleanup-feed
--continue-resync
Retoma uma operação de ressincronização interrompida. Suportado apenas para feeds products, productAttributes e productOverrides.
Exemplo:
bin/magento saas:resync --feed productAttributes --continue-resync
--dry-run
Executa o processo de reindexação do feed sem enviá-lo para o SaaS e sem salvá-lo na tabela de feed. Essa opção é útil para identificar quaisquer problemas com seu conjunto de dados.
Adicione a variável de ambiente EXPORTER_EXTENDED_LOG=1 para salvar a carga em var/log/saas-export.log.
Exemplo:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run
Testar itens específicos do feed
Teste itens específicos do feed adicionando a opção --by-ids com a coleção de logs estendidos para ver a carga gerada no arquivo var/log/saas-export.log.
Exemplo:
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'
Testar todos os itens do feed
Por padrão, o feed enviado durante uma operação resync --dry-run inclui somente itens novos ou itens que não foram exportados anteriormente. Para incluir todos os itens no feed a serem processados, use a opção --cleanup-feed.
Exemplo
bin/magento saas:resync --feed products --dry-run --cleanup-feed
--feed
Obrigatório. Especifica a entidade de feed a ser ressincronizada.
Feeds disponíveis:
categoriescategoryPermissionsorderspricesproductsproductAttributesproductOverridesscopesWebsitescopesCustomerGroupvariants
Exemplo:
bin/magento saas:resync --feed products
--no-reindex
Reenvia dados existentes do catálogo para Commerce Services sem reindexação. Não compatível com feeds relacionados ao produto.
O comportamento varia de modo de exportação:
- Modo herdado: reenvia todos os dados sem truncar.
- Modo imediato: a opção é ignorada, apenas sincroniza atualizações/falhas.
Exemplo:
bin/magento saas:resync --feed productAttributes --no-reindex
--id-type=ProductId
Por padrão, as entidades especificadas quando você usa o comando saas:resync feed com a opção --by-ids são especificadas pelo SKU do produto. Use a opção --id-type=ProductId para especificar entidades por ID de produto.
bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'
Exemplo:
Solução de problemas
Se você não vir os dados esperados nos Serviços Commerce conectados, solucione os problemas verificando os logs de erro da exportação de dados e usando o comando saas:resync com as variáveis de ambiente para revisar as cargas e os dados do criador de perfil. Consulte Revisar logs e solucionar problemas.