Sincronizar fuentes mediante la CLI de Commerce

Última actualización: 16 de abril de 2025
  • Temas:

Creado para:

  • Administrador

El comando saas:resync del paquete magento/saas-export le permite administrar la sincronización de datos para los servicios SaaS de Adobe Commerce.

Adobe no recomienda usar el comando saas:resync con regularidad. Los escenarios habituales para utilizar el comando son:

  • Sincronización inicial
  • Sincronizar datos a nuevo espacio de datos después de cambiar el ID de espacio de datos SaaS
  • Resolución de problemas

Supervisar operaciones de sincronización en el archivo var/log/saas-export.log.

Sincronización inicial

NOTE
La sincronización inicial se ejecuta automáticamente cuando Live Search o Product Recommendations están habilitados. No se necesitan comandos manuales.

Al almacenar en déclencheur un(a) saas:resync desde la línea de comandos, según el tamaño del catálogo, los datos pueden tardar entre unos minutos y unas pocas horas en actualizarse.

Para la sincronización inicial, Adobe recomienda ejecutar los comandos en el siguiente orden:

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 mediante comandos CLI

El comando saas:resync admite varias operaciones de sincronización:

  • Sincronización parcial por SKU
  • Reanudar sincronizaciones interrumpidas
  • Validar datos sin sincronizar

Ver todas las opciones disponibles:

bin/magento saas:resync --help

Consulte las secciones siguientes para ver descripciones de opciones con ejemplos.

NOTE
Para obtener opciones avanzadas para administrar el procesamiento de exportación, consulte Personalizar el procesamiento de exportación.

--by-ids

Resincronizar parcialmente entidades específicas mediante sus ID. Admite fuentes de products, productAttributes, productOverrides, inventoryStockStatus, prices, variants y categoryPermissions.

De forma predeterminada, las entidades se especifican en una lista separada por comas por SKU del producto. Para usar identificadores de producto, agregue la opción --id-type=ProductID.

Ejemplos:

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

Limpie la tabla de fuentes en la tabla del indexador de fuentes antes de reindexar y enviar datos a SaaS. Solo se admite para products, productAttributes, productOverrides, inventoryStockStatus, prices, variants y categoryPermissions.

Si se utiliza con la opción --dry-run, la operación realiza una operación de resincronización de ejecución en seco para todos los elementos.

IMPORTANT
Use solo después de limpiar el entorno o con la opción --dry-run. Si se utiliza en otros casos, la operación de limpieza provoca la pérdida de datos y problemas de sincronización de datos en los que los elementos que deben eliminarse en Adobe Commerce no se eliminan del espacio de datos SaaS.

Ejemplo:

bin/magento saas:resync --feed products --cleanup-feed

--continue-resync

Reanuda una operación de resincronización interrumpida. Solo se admite para las fuentes products, productAttributes y productOverrides.

Ejemplo:

bin/magento saas:resync --feed productAttributes --continue-resync

--dry-run

Ejecuta el proceso de reindexación de fuentes sin enviar la fuente a SaaS y sin guardar en la tabla de fuentes. Esta opción es útil para identificar cualquier problema con el conjunto de datos.

Agregue la variable de entorno EXPORTER_EXTENDED_LOG=1 para guardar la carga útil en var/log/saas-export.log.

Ejemplo:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run

Probar elementos de fuente específicos

Pruebe elementos de fuentes específicos agregando la opción --by-ids con la colección de registros extendida para ver la carga útil generada en el archivo var/log/saas-export.log.

Ejemplo:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='1,2,3'

Probar todos los elementos de fuente

De manera predeterminada, la fuente enviada durante una operación de resync --dry-run incluye solo elementos nuevos o elementos que no se pudieron exportar anteriormente. Para incluir todos los elementos en la fuente que se va a procesar, use la opción --cleanup-feed.

Ejemplo

bin/magento saas:resync --feed products --dry-run --cleanup-feed

--feed

Requerido. Especifica la entidad de fuente que se va a resincronizar.

Fuentes disponibles:

  • categories
  • categoryPermissions
  • inventoryStockStatus
  • orders
  • prices
  • products
  • productAttributes
  • productOverrides
  • scopesWebsite
  • scopesCustomerGroup
  • variants

Ejemplo:

bin/magento saas:resync --feed products