Sincronizar fuentes mediante la CLI de Commerce
El comando saas:resync del paquete magento/saas-export le permite administrar la sincronización de datos para los servicios SaaS de Adobe Commerce.
saas:resync también se aplica a Adobe Commerce Optimizer Connector fuentes como products, categories y priceBooks. Consulte Fuentes compatibles para obtener la lista completa de fuentes de conector y nombres de indizador.Adobe no recomienda usar el comando saas:resync con regularidad. Los escenarios habituales para utilizar el comando son:
- Sincronización inicial
- Sincronizar datos a un 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
aco:config:init programa la sincronización completa inicial invalidando todos los indexadores de fuentes de conector. Ver Habilitar la Commerce Optimizer integración y Administrar sincronización con Commerce Optimizer.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.
Las sincronizaciones de fuentes se pueden ejecutar en cualquier orden; no hay dependencias fijas entre ellas. La siguiente secuencia comienza primero con los datos de ámbito, lo que es un punto de partida lógico, ya que los ámbitos definen las vistas de almacén a las que hacen referencia otras fuentes.
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
Opciones de comando
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 y marcas de comando:
bin/magento saas:resync --help
Consulte las secciones siguientes para ver descripciones de opciones con ejemplos.
--feed
Requerido. Especifica la entidad de fuente que se va a resincronizar.
bin/magento saas:resync --help documentos opciones de comando y marcas. No enumera todas las fuentes disponibles en su entorno. Para obtener la lista completa de fuentes con nombres de fuentes CLI, ID de indizador y tablas de fuentes, consulte Fuentes compatibles.
productOverrides requiere Adobe Commerce en la nube, de forma local o Commerce as a Cloud Service, y orders requiere el módulo Pedidos de venta.Ejemplo:
bin/magento saas:resync --feed products
--by-ids
Resincronizar parcialmente entidades específicas mediante sus ID. Admite fuentes de products, productAttributes, productOverrides, inventoryStockStatus, prices, variants y categoryPermissions.
De manera predeterminada, al usar la opción --by-ids, se especifican valores mediante los valores de 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 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.
cleanup-feed borra el estado de exportación de la fuente local y puede provocar una sincronización incompleta. Por ejemplo, es posible que las eliminaciones de entidades en Adobe Commerce no se reflejen en los servicios de Commerce conectados, o que las entidades antiguas permanezcan en los índices remotos de los servicios de Commerce aunque se eliminaron o actualizaron en Adobe Commerce. Utilice esta opción solo para reconstrucciones de entorno completas, como después de una limpieza 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='ADB102,ADB111,ADB112'
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
--no-reindex
Vuelve a enviar los datos del catálogo existente a Commerce Services sin volver a indexar. No compatible con fuentes relacionadas con productos.
El comportamiento varía según el modo de exportación:
- Modo heredado: vuelve a enviar todos los datos sin truncarlos.
- Modo inmediato: la opción se ignora, solo sincroniza actualizaciones/errores.
Ejemplo:
bin/magento saas:resync --feed productAttributes --no-reindex