El procesamiento por lotes proporciona una forma de despachar un conjunto de operaciones, que pueden ser interdependientes, a varios servicios sin tener que esperar de manera síncrona a que se completen las operaciones. Puedes usar el procesamiento por lotes para crear y administrar campañas de máximo rendimiento.
En esta guía, se proporcionan detalles específicos de las campañas de máximo rendimiento cuando se trabaja con el procesamiento por lotes. La guía de procesamiento por lotes genérica proporciona información general sobre el procesamiento por lotes, y la guía de solicitudes de estructura contiene información detallada sobre la creación de solicitudes para crear o administrar campañas de máximo rendimiento.
Para crear una campaña de máximo rendimiento con procesamiento por lotes, sigue estos pasos:
Crear un nuevo trabajo por lotes
Sigue el paso de creación de trabajo general del procesamiento por lotes para crear un recurso BatchJob
.
Prepara una lista de operaciones de modificación
Las campañas de máximo rendimiento requieren operaciones para crear varios recursos relacionados, que se detallan en la Guía de solicitudes de estructura. Crea un MutateOperation
para cada recurso que se deba incluir en el trabajo por lotes.
Requisitos de AssetGroupOperation
y AssetGroupAssetOperation
Las operaciones de tipo MutateOperation
que crean recursos AssetGroup
y AssetGroupAsset
en un trabajo por lotes deben ser secuenciales sin otras operaciones intermedias debido a la forma en que estas operaciones se agrupan cuando se procesan. De lo contrario, la solicitud arroja una AssetGroupError
que indica que faltan algunos recursos, incluso si las operaciones necesarias para cumplir con los requisitos mínimos de los recursos se incluyen más adelante en la lista de operaciones.
AssetGroupListingGroupFilterOperation
prácticas recomendadas
Cuando trabajes con filtros de grupos de listas en el contexto de una AssetGroupListingGroupFilter
, recomendamos agregar operaciones AssetGroupListingGroupFilterOperation
orientadas al mismo AssetGroup
a un trabajo por lotes de forma consecutiva, de modo que el conjunto de operaciones se trate de forma atómica durante la división por lotes. Para obtener más información sobre la división por lotes y otros factores que afectan los grupos de fichas, consulta la guía de procesamiento por lotes de grupos de fichas.
Agrega las operaciones de mutación al trabajo
Agrega las operaciones de mutación del Paso 2 a una lista y llama a AddBatchJobOperations
para agregar la lista de mutaciones al trabajo por lotes creado en el Paso 1.
Sigue el paso de adición de operaciones de la guía general de procesamiento por lotes para agregar la lista de operaciones de mutación.
Ejecuta el trabajo por lotes
Llama a RunBatchJob
para permitir que los trabajos subidos comiencen a ejecutarse. Consulta el paso Ejecuta el trabajo por lotes de la guía general de procesamiento por lotes para ver un ejemplo.
Recupera el estado del trabajo
Los trabajos por lotes comienzan como operaciones de larga duración y, por lo general, tardan en completarse.
Después de iniciar el trabajo, usa el método GetOperation
de la operación de larga duración para sondear el estado del trabajo hasta que se complete.
Cuando finalicen todos tus trabajos por lotes, llama a ListBatchJobResults
para imprimir sus estados y respuestas según el paso enumerar todos los resultados de trabajos por lotes de la guía general de procesamiento por lotes.