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 Adobe Commerce.
saas:resync também se aplica aos feeds Adobe Commerce Optimizer Connector, como products, categories e priceBooks. Consulte Feeds com suporte para obter a lista completa de feeds de conector e nomes de indexador.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
aco:config:init agenda a sincronização completa inicial, invalidando todos os indexadores de feed de conector. Consulte Habilitar a Commerce Optimizer integração e Gerenciar sincronização com Commerce Optimizer.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.
As sincronizações de feed podem ser executadas em qualquer ordem - não há dependências permanentes entre elas. A sequência a seguir começa com os dados do escopo primeiro, que é um ponto de partida lógico, pois os escopos definem as exibições de armazenamento referenciadas por outros feeds.
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed productAttributes
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed products
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed productoverrides
Opções de comando
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 e sinalizadores de comando:
bin/magento saas:resync --help
Consulte as seções a seguir para obter descrições de opções com exemplos.
--feed
Obrigatório. Especifica a entidade de feed a ser ressincronizada.
bin/magento saas:resync --help opções e sinalizadores de comando de documentos. Ele não lista cada feed disponível em seu ambiente. Para obter a lista completa de feeds com nomes de CLI, IDs de indexador e tabelas de feed, consulte Feeds com suporte.
productOverrides exige Adobe Commerce na nuvem, no local ou Commerce as a Cloud Service, e orders exige o módulo de Ordens de Venda.Exemplo:
bin/magento saas:resync --feed products
--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 em 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 em Adobe Commerce. Use essa opção somente para recriações completas do 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
--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