پردازش دسته‌ای برای «عملکرد بیشینه»

پردازش دسته‌ای روشی برای ارسال مجموعه‌ای از عملیات‌ها (که ممکن است به یکدیگر وابسته باشند) به چندین سرویس بدون انتظار هم‌زمان برای تکمیل عملیات‌ها ارائه می‌دهد. می‌توانید از پردازش دسته‌ای برای ایجاد و مدیریت کمپین‌های «عملکرد بیشینه» استفاده کنید.

این راهنما جزئیات خاصی را برای پویش‌های «بیشینه‌سازی عملکرد» هنگام کار با پردازش دسته‌ای ارائه می‌دهد. راهنمای پردازش دسته‌ای عمومی اطلاعات کلی درباره پردازش دسته‌ای ارائه می‌دهد و راهنمای ساختار درخواست‌ها حاوی اطلاعات دقیق درباره ساخت درخواست‌ها برای ایجاد یا مدیریت پویش‌های «بیشینه‌سازی عملکرد» است.

برای ایجاد پویش «بیشینه‌سازی عملکرد» بااستفاده از پردازش دسته‌ای، این مراحل را دنبال کنید:

ایجاد کار دسته‌ای جدید

مرحله ایجاد کار پردازش دسته‌ای عمومی را برای ایجاد منبع BatchJob دنبال کنید.

فهرستی از عملیات تغییریافته آماده کنید

پویش‌های «عملکرد بیشینه» برای ایجاد چندین منبع مرتبط به عملیات نیاز دارند که در راهنمای درخواست‌های ساختار به‌طور مفصل شرح داده شده است. برای هر منبعی که باید در کار دسته‌ای گنجانده شود، یک MutateOperation ایجاد کنید.

الزامات CampaignOperation و CampaignAssetOperation

وقتی رهنمودهای نمانام برای پویشی فعال باشد (به رهنمودهای نمانام مراجعه کنید)، باید دارایی‌های نمانام را بااستفاده از منابع CampaignAsset به پویش پیوند دهید. علاوه‌براین، در کار دسته‌ای، ایجاد این منابع CampaignAsset باید بلافاصله پس‌از ایجاد خود منبع Campaign انجام شود. اگر منابع CampaignAsset بلافاصله پس‌از منبع Campaign ایجاد نشوند (وقتی رهنمودهای نمانام فعال باشند - به عیب‌یابی مراجعه کنید)، درخواست ناموفق خواهد بود و CampaignError برمی‌گرداند که نشان‌دهنده دارایی‌های مفقود است. گنجاندن عملیات ایجاد CampaignAsset در ادامه همان فهرست عملیات‌ها مانع از بروز این خطا نمی‌شود.

الزامات AssetGroupOperation و AssetGroupAssetOperation

عملیات‌های نوع MutateOperation که منابع AssetGroup و AssetGroupAsset را در کار دسته‌ای ایجاد می‌کنند باید متوالی باشند و عملیات دیگری بین آن‌ها نباشد، زیرا این عملیات‌ها هنگام پردازش باهم گروه‌بندی می‌شوند. درغیراین‌صورت، درخواست AssetGroupError را برمی‌گرداند که نشان می‌دهد برخی‌از دارایی‌ها وجود ندارند، حتی اگر عملیات لازم برای برآورده کردن حداقل الزامات دارایی بعداً در فهرست عملیات گنجانده شود.

روال‌های مطلوب AssetGroupListingGroupFilterOperation

هنگام کار با فیلترهای گروه فهرستگان در بافت AssetGroupListingGroupFilter، توصیه می‌کنیم عملیات AssetGroupListingGroupFilterOperation را که همان AssetGroup را هدف قرار می‌دهند به‌طور متوالی به یک کار دسته‌ای اضافه کنید تا مجموعه عملیات به‌صورت اتمی درطول تقسیم دسته‌ای پردازش شوند. برای مطالعه بیشتر درباره تقسیم دسته‌ای و سایر عوامل تأثیرگذار بر گروه‌های فهرستگان، به راهنمای پردازش دسته‌ای گروه فهرستگان مراجعه کنید.

افزودن عملیات جهش به کار

عملیات جهش را از مرحله ۲ به فهرست اضافه کنید و AddBatchJobOperations را فراخوانی کنید تا فهرست جهش‌ها به کار دسته‌ای ایجادشده در مرحله ۱ اضافه شود. مرحله افزودن عملیات را در راهنمای کلی پردازش دسته‌ای دنبال کنید تا فهرست عملیات تغییر را اضافه کنید.

اجرای کار دسته‌ای

با فراخوانی RunBatchJob، به کارهای بارگذاری‌شده اجازه دهید اجرا شوند. برای مشاهده نمونه، به مرحله اجرای کار دسته‌ای در راهنمای کلی پردازش دسته‌ای مراجعه کنید.

بازیابی وضعیت کار

کارهای دسته‌ای به‌عنوان عملیات طولانی‌مدت شروع می‌شوند و معمولاً مدتی طول می‌کشد تا تمام شوند. پس‌از شروع کار، از روش GetOperation عملیات طولانی‌مدت برای نظرسنجی وضعیت کار تا زمان تکمیل آن استفاده کنید.

وقتی همه کارهای دسته‌ای شما تمام شد، ListBatchJobResults را فراخوانی کنید تا وضعیت‌ها و پاسخ‌های آن‌ها را طبق مرحله فهرست کردن همه نتایج کار دسته‌ای در راهنمای کلی پردازش دسته‌ای چاپ کنید.