DocumentaçãoCommerceData Export

Sincronizar dados com a exportação de dados SaaS

Última atualização: 17 de junho de 2026

Criado para:

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Quando você instala um serviço do Adobe Commerce que requer exportação de dados, como Serviço de Catálogo, Live Search ou Recomendações de Produto, uma coleção de módulos de exportação de dados SaaS é instalada para gerenciar o processo de coleta e sincronização de dados.

A exportação de dados SaaS move os dados do produto de uma instância do Adobe Commerce para a plataforma de serviços da Commerce de forma contínua para manter os dados atualizados. Por exemplo, as Recomendações de produto exigem informações atuais do catálogo para retornar com precisão as recomendações com nomes, preços e disponibilidade corretos. Para obter detalhes sobre o monitoramento do processo de sincronização, consulte Exibir e gerenciar o processo de sincronização.

O diagrama a seguir mostra o fluxo de exportação de dados SaaS.

Coleta de exportação de dados SaaS e fluxo de sincronização para Adobe Commerce {width="900" modal="regular"}

Quando os dados do catálogo são alterados no Adobe Commerce, a sincronização percorre esses estágios.

  1. Detecção de alteração de entidade - O sistema Mview da Magento detecta alterações de linha em tabelas de banco de dados assinadas (por exemplo, catalog_product_entity) e grava entradas em uma tabela de log de alterações.
  2. Indexação de feed - O indexador de feed lê o changelog, carrega dados de entidade das tabelas de origem e monta itens de feed.
  3. Coleta e transformação de dados - Os provedores registrados no esquema de feed et_schema.xml coletam dados de campo.
  4. Desduplicação de hash - Um hash de conteúdo é calculado para cada item de feed. Os itens cujo hash não foi alterado desde a última exportação são ignorados, portanto, somente os dados modificados são transmitidos.
  5. Envio de HTTP - Os itens de feed são enviados como lotes HTTP POST autenticados para o Serviço de Assimilação de Feed SaaS do Adobe.
  6. Persistência do status - O status de resposta da API é gravado de volta na tabela de feed para cada item.
  7. Nova tentativa com falha - Os itens que não foram exportados são automaticamente repetidos por um trabalho cron agendado.
NOTE
Para Adobe Commerce Optimizer Connector implantações, SaaS Data Export manipula a detecção de alteração de entidade e o assembly de feed. O conector mapeia os feeds para o formato Catalog Data Ingestion API e os envia para Adobe Commerce Optimizer. Consulte Pipeline de sincronização do conector para controle de escopo, envio e tratamento de erros.
NOTE
Para garantir uma programação perfeita e evitar interrupções nas operações do site, a Adobe recomenda estimar o volume de dados e o tempo de sincronização antes de iniciar qualquer sincronização do feed de dados. Essa estimativa é importante ao planejar sincronizações iniciais ou atualizações de catálogos em larga escala, como alterações de preço em massa. Para obter detalhes, consulte Estimar volume de dados e tempo de transmissão para sincronização de dados

Modos de sincronização

A exportação de dados SaaS tem dois modos para processar feeds de entidade:

  • Modo de exportação imediata — Neste modo, os dados são coletados e enviados imediatamente para o Commerce Service em uma única iteração. Esse modo acelera a entrega de atualizações de entidades ao serviço do Commerce e reduz o tamanho do armazenamento das tabelas de feed.

  • Modo de exportação herdado — Neste modo, os dados são coletados em um único processo. Em seguida, um trabalho cron envia os dados coletados para os serviços de comércio conectados. Nas entradas do log de exportação de dados, os feeds que usam o modo herdado são rotulados como (legacy).

Tipos de sincronização

A exportação de dados SaaS suporta três tipos de sincronização - sincronização completa, sincronização parcial e nova tentativa de sincronização de itens com falha.

Sincronização completa

Depois de conectar uma instância do Adobe Commerce ao Commerce Service, execute uma sincronização completa para enviar dados de feed de entidade do Adobe Commerce para o serviço conectado.

NOTE
A sincronização completa é principalmente para a fase de integração. Evite o uso regular para evitar a sobrecarga do banco de dados. Após a sincronização inicial, as alterações em andamento são sincronizadas automaticamente usando a sincronização parcial.

Sincronização parcial partial-sync

Com a sincronização parcial, a exportação de dados SaaS envia automaticamente as atualizações do aplicativo Commerce, como alterações de nome de produto ou atualizações de preço, para os serviços de comércio conectados.
Para que a sincronização parcial funcione, o aplicativo Commerce requer a seguinte configuração:

Repetir sincronização de itens com falha retry-failed-items-sync

A sincronização Repetir itens com falha usa um processo separado para reenviar itens que não foram sincronizados devido a erros durante o processo de sincronização, por exemplo, um erro de aplicativo, uma interrupção de rede ou um erro de serviço SaaS. Os trabalhos cron *_resend_failed_items no grupo resync_failed_feeds_data_exporter lidam com isso automaticamente a cada 5 minutos.

Trabalhos cron agendados

Os grupos cron a seguir automatizam o pipeline em uma programação fixa.

Grupo Cron
Trabalho Cron
Finalidade
Cronograma
index
indexer_update_all_views
Processa os changelogs do Mview e aciona as atualizações parciais do feed
A cada 1 minuto
index
indexer_reindex_all_invalid
Executa uma ressincronização completa para índices de feed marcados como “Reindexação necessária”
A cada 1 minuto
resync_failed_feeds_data_exporter
*_resend_failed_items
Detecta itens de feed com falha e os reenvia
A cada 5 minutos
commerce_data_export
saas_data_exporter
Envia dados para feeds do modo herdado (pedidos, escopos)
A cada 5 minutos
commerce_data_export
cleanup_deleted_feed_items
Limpa itens de feed excluídos sincronizados após o período de retenção (7 dias)
Todos os dias às 2:00 AM

Envio de feed e tratamento de erros HTTP feed-submission-and-http-error-handling

Os itens de feed são enviados como lotes JSON autenticados compactados com gzip por HTTP POST. A tabela a seguir mostra como os códigos de resposta HTTP são mapeados para o status de exportação e para o comportamento de nova tentativa.

Código de status
Tentar novamente?
Significado
200
Não
Aceito com êxito
400
Não
Dados inválidos ou falha na validação - requer investigação manual. Verifique var/log/saas-export-errors.log para obter detalhes.
429
Sim
Acerto de limite de taxa - reduzir thread_count em configurações de processamento de exportação
5xx
Sim
Erro do lado SaaS - nova tentativa automática
2
Sim
O item está programado para nova tentativa

Além de falhas de nível HTTP, erros de nível de aplicativo, como falhas de processamento local ou interrupções de rede, também são agendados para repetição automática pelos trabalhos cron *_resend_failed_items.

Monitorar status por feed da página Data Feed Sync Status no Administrador do Commerce.

Related Articles
recommendation-more-help
commerce-help-data-export