قم بتحرير إعدادات المضيف والتطبيق لتطبيقات المنطق القياسي في Azure Logic Apps للمستأجر الفردي

ينطبق على: Azure Logic Apps (قياسي)

في Azure Logic Apps أحادية المستأجر ، تحدد إعدادات التطبيق لتطبيق منطق قياسي خيارات التكوين العمومية التي تؤثر على جميع مهام سير العمل في هذا التطبيق المنطقي. ومع ذلك، تنطبق هذه الإعدادات فقط عند تشغيل مهام سير العمل هذه في بيئة التطوير المحلية. يمكن لمهام سير العمل التي يتم تشغيلها محلياً الوصول إلى إعدادات التطبيق هذه باعتبارها متغيرات البيئة المحلية، والتي تستخدمها أدوات التطوير المحلية للقيم التي يمكن أن تتغير غالباً بين البيئات. على سبيل المثال، يمكن أن تحتوي هذه القيم على سلاسل الاتصال. عندما تقوم بالتوزيع في Azure، يتم تجاهل إعدادات التطبيق ولا يتم تضمينها في التوزيع الخاص بك.

يحتوي التطبيق المنطقي أيضاً على إعدادات المضيف، والتي تحدد إعدادات وقيم تكوين وقت التشغيل التي تنطبق على جميع مهام سير العمل في التطبيق المنطقي هذا، على سبيل المثال، القيم الافتراضية للمعدل نقل والسعة والبيانات الحجم وما إلى ذلك، سواء كانت تعمل محلياً أو في Azure.

إعدادات التطبيق والمعلمات والتوزيع

في Azure Logic Apps متعددة المستأجرين، يعتمد النشر على قوالب Azure Resource Manager (قوالب ARM)، التي تجمع بين إدارة الموارد وتعالجها لكل من التطبيقات المنطقية والبنية الأساسية. يشكل هذا التصميم تحدياً عندما يتعين عليك الحفاظ على متغيرات البيئة للتطبيقات المنطقية عبر بيئات التطوير والاختبار والإنتاج المختلفة. يتم تعريف كل شيء في قالب ARM عند التوزيع. إذا كنت بحاجة إلى تغيير متغير واحد فقط، فعليك إعادة توزيع كل شيء.

في تطبيقات أحادية المستأجر Azure Logic Apps يصبح التوزيع أسهل لأنه يمكنك فصل توفير الموارد بين التطبيقات والبنية الأساسية. يمكنك استخدام معلمات لاستخراج القيم التي قد تتغير بين البيئات. من خلال تحديد المعلمات لاستخدامها في مهام سير العمل، يمكنك التركيز أولاً على تصميم مهام سير العمل، ثم إدراج المتغيرات الخاصة بالبيئة لاحقاً. يمكنك استدعاء والإشارة إلى متغيرات البيئة الخاصة بك في وقت التشغيل باستخدام إعدادات ومعلمات التطبيق. بهذه الطريقة، لن تضطر إلى إعادة التوزيع كثيراً.

تتكامل إعدادات التطبيق مع Azure Key Vault. يمكنك الإشارة مباشرة إلى السلاسل الآمنة، مثل سلاسل الاتصال والمفاتيح. على غرار قوالب Azure Resource Manager (قوالب ARM)، حيث يمكنك تحديد متغيرات البيئة في وقت التوزيع، يمكنك تحديد إعدادات التطبيق ضمن تعريف سير عمل التطبيق المنطقي. يمكنك بعد ذلك تسجيل قيم البنية الأساسية التي تم إنشاؤها ديناميكياً، مثل نقاط نهاية الاتصال وسلاسل التخزين والمزيد. ومع ذلك، فإن إعدادات التطبيق لها قيود على الحجم ولا يمكن الرجوع إليها من مناطق معينة في Azure Logic Apps.

إشعار

إذا كنت تستخدم Key Vault، فتأكد من تخزين الأسرار فقط، مثل كلمات المرور وبيانات الاعتماد والشهادات. في سير عمل التطبيق المنطقي، لا تستخدم Key Vault لتخزين القيم غير السرية، مثل مسارات URL، التي يحتاجها مصمم سير العمل لإجراء مكالمات. لا يمكن للمصمم إلغاء مرجعية إعداد تطبيق يشير إلى نوع مورد Key Vault، ما يؤدي إلى حدوث خطأ واستدعاء فاشل. بالنسبة للقيم غير السرية، قم بتخزينها مباشرة في إعدادات التطبيق.

لمزيد من المعلومات بشأن إعداد تطبيقاتك المنطقية للتوزيع، راجع الوثائق التالية:

بنية مشروع Visual Studio Code

في Visual Studio Code، يشتمل مشروع logic app على أحد الأنواع التالية:

  • تعتمد على حزمة الملحقات (Node.js)، وهي النوع الافتراضي
  • NuGet مستند إلى الحزم (.NET)، والذي يمكنك تحويله من النوع الافتراضي

بناءً على هذه الأنواع، يتضمن مشروعك مجلدات وملفات مختلفة قليلاً. يتضمن المشروع المستند إلى NuGet مجلد .bin يحتوي على حزم وملفات مكتبة أخرى. لا يتضمن المشروع المستند إلى الحزم مجلد .bin وملفات أخرى. تتطلب بعض السيناريوهات مشروعاً يستند إلى NuGet لتشغيل تطبيقك، على سبيل المثال، عندما تريد تطوير عمليات مضمنة مخصصة وتشغيلها. لمزيد من المعلومات بشأن تحويل مشروعك لاستخدام NuGet، راجع تمكين تأليف الموصل المدمج.

بالنسبة إلى المشروع الافتراضي المستند إلى الحزمة، يحتوي مشروعك على بنية مجلد وملف مشابه للمثال التالي:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

على مستوى جذر مشروعك، يمكنك العثور على الملفات والمجلدات التالية مع عناصر أخرى:

الاسم مجلد أو ملف ‏‏الوصف
.vscode مجلد يحتوي على ملفات الإعدادات المتعلقة بـ Visual Studio Code، مثل ملفات extension.json وlaunch.json وsettings.json وfeatures.json .
التحف مجلد يحتوي على البيانات الاصطناعية حساب التكامل التي تحددها وتستخدمها في مهام سير العمل التي تدعم سيناريوهات الأعمال التجارية (B2B). على سبيل المثال، تتضمن بنية المثال الخرائط والمخططات لعمليات تحويل XML والتحقق من الصحة.
<WorkflowName> مجلد لكل سير عمل، يتضمن المجلد <WorkflowName> ملف workflow.json، والذي يحتوي على تعريف JSON الأساسي لسير العمل.
workflow-designtime مجلد يحتوي على ملفات الإعدادات المتعلقة ببيئة التطوير.
.funcignore الملف يحتوي على معلومات تتعلق بـ Azure Functions Core Toolsالمثبتة لديك.
connections.json الملف يحتوي على البيانات التعريفية ونقاط النهاية والمفاتيح لأي اتصالات مُدارة وAzure Functions التي تستخدمها مهام سير العمل.

هام: لاستخدام اتصالات ووظائف مختلفة لكل بيئة، تأكد من تخصيص ملف links.json هذا وتحديث نقاط النهاية.
host.json الملف يحتوي على إعدادات وقيم التكوين الخاصة بوقت التشغيل، على سبيل المثال، الحدود الافتراضية لنظام Azure Logic Apps الأساسي للمستأجر الفردي، والتطبيقات المنطقية، ومهام سير العمل، والمشغلات، والإجراءات. في المستوى الجذر لمشروع تطبيقك المنطقي، يحتوي ملف بيانات التعريف host.json على إعدادات التكوين والقيم الافتراضية التي تستخدمها جميع مهام سير العمل في نفس التطبيق المنطقي خلال التشغيل، سواء محلياً أو في Azure.

ملاحظة: عند إنشاء تطبيقك المنطقي، يقوم Visual Studio Code بإنشاء نسخة احتياطية من ملف host.snapshot. *. json في حاوية التخزين الخاصة بك. إذا قمت بحذف التطبيق المنطقي الخاص بك، فلن يتم حذف ملف النسخ الاحتياطي هذا. إذا قمت بإنشاء تطبيق منطق آخر بنفس الاسم، فسيتم إنشاء ملف لقطة آخر. يمكنك الحصول على ما يصل إلى 10 لقطات فقط لنفس تطبيق المنطق. إذا تجاوزت هذا الحد، فستحصل على الخطأ التالي:

Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))

لحل هذا الخطأ، احذف ملفات اللقطة الإضافية من حاوية التخزين الخاصة بك.
local.settings.json الملف يحتوي على إعدادات التطبيق وسلاسل الاتصال والإعدادات الأخرى التي تستخدمها مهام سير العمل خلال التشغيل محلياً. بمعنى آخر، تنطبق هذه الإعدادات والقيم فقط عند تشغيل مشروعاتك في بيئة التطوير المحلية الخاصة بك. خلال التوزيع إلى Azure، يتم تجاهل الملف والإعدادات ولا يتم تضمينها في التوزيع الخاص بك.

يخزن هذا الملف الإعدادات والقيم باعتبارها متغيرات البيئة المحلية التي تستخدمها أدوات التطوير المحلية كقيم appSettings. يمكنك استدعاء متغيرات البيئة هذه والإشارة إليها في وقت التشغيل ووقت التوزيع باستخدام إعدادات التطبيق والمعلمات.

هام: يمكن أن يحتوي ملف local.settings.json على بيانات سرية، لذا تأكد من استبعاد هذا الملف أيضاً من التحكم في مصدر المشروع.

مرجع لإعدادات التطبيق - local.settings.json

في Visual Studio Code، على مستوى جذر مشروع التطبيق المنطقي، يحتوي ملف local.settings.json على خيارات تكوين عامة تؤثر على جميع مهام سير العمل في التطبيق المنطقي هذا خلال التشغيل في التطوير المحلي. بيئة. عند تشغيل مهام سير العمل محلياً، يتم الوصول إلى هذه الإعدادات كمتغيرات البيئة المحلية، ويمكن أن تتغير قيمها غالباً بين البيئات المختلفة التي تقوم فيها بتشغيل مهام سير العمل الخاصة بك. لعرض هذه الإعدادات وإدارتها، راجع إدارة إعدادات التطبيق - local.settings.json.

تعمل إعدادات التطبيق في Azure Logic Apps بشكل مشابه لإعدادات التطبيق في Azure Functions أو Azure Web Apps. إذا كنت قد استخدمت هذه الخدمات الأخرى من قبل، فقد تكون على دراية بإعدادات التطبيق بالفعل. لمزيد من المعلومات، راجع مرجع إعدادات التطبيق لـ Azure Functions والعمل باستخدام Azure Functions Core Tools - ملف الإعدادات المحلية.

الإعدادات القيمة الافتراضية الوصف
AzureWebJobsStorage بلا يعيّن سلسلة الاتصال لحساب تخزين Azure. لمزيد من المعلومات، راجع AzureWebJobsStorage
FUNCTIONS_WORKER_RUNTIME node تعيين وقت تشغيل عامل اللغة لاستخدامه مع مورد تطبيق المنطق وسير العمل. ومع ذلك، لم يعد هذا الإعداد ضروريا بسبب الدعم متعدد اللغات الممكن تلقائيا.

لمزيد من المعلومات، راجع FUNCTIONS_WORKER_RUNTIME.
ServiceProviders.Sftp.FileUploadBufferTimeForTrigger 00:00:20
(20 ثانية)
تعيين وقت المخزن المؤقت لتجاهل الملفات التي تحتوي على آخر طابع زمني معدل أكبر من الوقت الحالي. يكون هذا الإعداد مفيدا عندما تستغرق عمليات كتابة الملفات الكبيرة وقتا طويلا وتتجنب إحضار البيانات لملف مكتوب جزئيا.
ServiceProviders.Sftp.OperationTimeout 00:02:00
(2 دقيقة)
تعيين الوقت للانتظار قبل انتهاء المهلة في أي عملية.
ServiceProviders.Sftp.ServerAliveInterval 00:30:00
(30 دقيقة)
إرسال رسالة "البقاء على قيد الحياة" للحفاظ على اتصال SSH نشطا إذا لم يحدث أي تبادل للبيانات مع الخادم خلال الفترة المحددة.
ServiceProviders.Sftp.SftpConnectionPoolSize 2 اتصالات تعيين عدد الاتصالات التي يمكن لكل معالج تخزينها مؤقتا. إجمالي عدد الاتصالات التي يمكنك تخزينها مؤقتا هو ProcessorCount مضروبا في قيمة الإعداد.
ServiceProviders.MaximumAllowedTriggerStateSizeInKB 10كيلوبايت، وهو حوالي 1000 ملف تعيين حجم كيان حالة المشغل بالكيلو بايت، والذي يتناسب مع عدد الملفات في المجلد المراقب ويتم استخدامه للكشف عن الملفات. إذا تجاوز عدد الملفات 1000 ملف، فقم بزيادة هذه القيمة.
ServiceProviders.Sql.QueryTimeout 00:02:00
(2 دقيقة)
يضبط قيمة مهلة الطلب لعمليات مزود خدمة SQL.
WEBSITE_LOAD_ROOT_CERTIFICATES بلا يضبط بصمات الأصابع للشهادات الجذرية المراد الوثوق بها.
Workflows.Connection.AuthenticationAudience بلا تعيين الجمهور لمصادقة اتصال مدار (مستضاف من Azure).
Workflows.CustomHostName بلا تعيين اسم المضيف لاستخدامه لعناوين URL الخاصة بسير العمل وإخراج الإدخال، على سبيل المثال، "logic.contoso.com". للحصول على معلومات لتكوين اسم DNS مخصص، راجع تعيين اسم DNS مخصص موجود إلى Azure App Service وتأمين اسم DNS مخصص مع ربط TLS/SSL في Azure App Service.
Workflows.<workflowName>.FlowState بلا يعيّن حالة <workflowName>.
Workflows.<workflowName>.RuntimeConfiguration.RetentionInDays بلا تعيين مقدار الوقت بالأيام للاحتفاظ بمحفوظات التشغيل ل <workflowName>.
Workflows.RuntimeConfiguration.RetentionInDays 90 أيام تعيين مقدار الوقت بالأيام للاحتفاظ بمحفوظات تشغيل سير العمل بعد بدء التشغيل.
Workflows.WebhookRedirectHostUri بلا يعيّن اسم المضيف المراد استخدامه لعناوين URL لرد الاتصال عبر الرد التلقائي على الويب.

إدارة إعدادات التطبيق - local.settings.json

لإضافة إعدادات التطبيق أو تحديثها أو حذفها، حدد وراجع الأقسام التالية لقالب مدخل Microsoft Azure أو Visual Studio Code أو Azure CLI أو ARM (Bicep). بالنسبة لإعدادات التطبيق الخاصة بالتطبيقات المنطقية، راجع الدليل المرجعي لإعدادات التطبيق المتاحة - local.settings.json.

عرض إعدادات التطبيق في المدخل
  1. في مربع البحث مدخل Microsoft Azure، ابحث عن التطبيق المنطقي وافتحه.

  2. في قائمة logic app، ضمن الإعدادات، حدد Environment variables.

  3. في صفحة متغيرات البيئة، في علامة التبويب إعدادات التطبيق، راجع إعدادات التطبيق لتطبيقك المنطقي.

    لمزيد من المعلومات بشأن هذه الإعدادات، راجع الدليل المرجعي لإعدادات التطبيق المتاحة - local.settings.json.

  4. لعرض جميع القيم، حدد Show Values. أو، لعرض قيمة واحدة، في عمود القيمة ، بجوار القيمة، حدد "العين".

إضافة إعداد تطبيق في المدخل
  1. في علامة التبويب إعدادات التطبيق، في أسفل القائمة، في العمود الاسم ، أدخل المفتاح أو الاسم لإعدادك الجديد.

  2. بالنسبة إلى القيمة، أدخل قيمة الإعداد الجديد.

  3. عندما تكون مستعدا لإنشاء زوج قيم المفاتيح الجديد، حدد تطبيق.

    تظهر لقطة الشاشة مدخل Microsoft Azure مع صفحة إعدادات التطبيق والقيم لمورد تطبيق منطق قياسي.

مرجع لإعدادات المضيف - host.json

في Visual Studio Code، على مستوى جذر مشروع التطبيق المنطقي، يحتوي ملف بيانات التعريف host.json على إعدادات وقت التشغيل والقيم الافتراضية التي تنطبق على جميع مهام سير العمل في مورد تطبيق منطقي سواء كان قيد التشغيل محلياً أو في Azure. لعرض هذه الإعدادات وإدارتها، راجع إدارة إعدادات المضيف - host.json. يمكنك أيضاً العثور على معلومات الحدود ذات الصلة في وثائق حدود وتكوين Azure Logic Apps.

معدل نقل تنسيق العمل

تؤثر هذه الإعدادات على معدل النقل وقدرة Azure Logic Apps للمستأجر الفردي لتشغيل عمليات سير العمل.

الإعدادات القيمة الافتراضية ‏‏الوصف
Jobs.BackgroundJobs.DispatchingWorkersPulseInterval 00:00:01
(1 ثانية)
يضبط الفاصل الزمني لمرسلي الوظائف لاستقصاء قائمة انتظار الوظائف عندما لا يُرجع الاستطلاع السابق أي وظائف. يقوم مرسلو الوظائف باستقصاء قائمة الانتظار فوراً عندما يقوم الاستطلاع السابق بإرجاع وظيفة.
Jobs.BackgroundJobs.NumPartitionsInJobDefinitionsTable 4 أقسام الوظيفة يضبط عدد أقسام الوظيفة في جدول تعريف الوظيفة. تتحكم هذه القيمة في مقدار معدل النقل الذي يتأثر بحدود تخزين القسم.
Jobs.BackgroundJobs.NumPartitionsInJobTriggersQueue 1 قائمة انتظار الوظائف يعيّن عدد قوائم انتظار الوظائف التي يراقبها مرسلو المهام لكي تتم معالجة المهام. تؤثر هذه القيمة أيضاً على عدد أقسام التخزين حيث توجد قوائم انتظار الوظائف.
Jobs.BackgroundJobs.NumWorkersPerProcessorCount 192 مثيلات عامل المرسل يعيّن عدد dispatcher worker instances أو job dispatchers لكل مركز معالج. تؤثر هذه القيمة على عدد عمليات سير العمل لكل مركز.
Jobs.BackgroundJobs.StatelessNumWorkersPerProcessorCount 192 مثيلات عامل المرسل تعيين عدد مثيلات عامل المرسل أو المرسلين الوظيفيين ليكون لكل ذاكرة أساسية للمعالج، لكل تشغيل عديم الحالة. تؤثر هذه القيمة على عدد إجراءات سير العمل المتزامنة التي تتم معالجتها لكل تشغيل.

يتم استخدام كلا الإعدادين التاليين لإيقاف مهام سير العمل المحددة وحذفها يدويا في تطبيق المنطق القياسي.

إشعار

استخدم هذه الإعدادات بحذر وفي البيئات غير الإنتاجية فقط، مثل بيئات اختبار التحميل أو الأداء، حيث لا يمكنك التراجع عن هذه العمليات أو استردادها.

الإعدادات القيمة الافتراضية الوصف
Jobs.CleanupJobPartitionPrefixes بلا يحذف على الفور جميع مهام التشغيل لسير العمل المحدد.
Jobs.SuspendedJobPartitionPartitionPrefixes بلا إيقاف مهام التشغيل لسير العمل المحدد.

يوضح المثال التالي بناء الجملة لهذه الإعدادات حيث يتبع كل معرف سير عمل علامة نقطتين (:) ويفصلها فاصلة منقوطة (;):

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

مشغلات مستندة إلى التكرار

الإعدادات القيمة الافتراضية ‏‏الوصف
Microsoft.Azure.Workflows.ServiceProviders.MaximumAllowedTriggerStateSizeInKB 1 كيلوبايت يضبط الحد الأقصى للحجم المسموح به لحالة التشغيل للمشغلات المستندة إلى التكرار مثل مشغل SFTP المدمج. تستمر حالة التشغيل في البيانات عبر مشغلات متعددة تستند إلى التكرار لمقدم الخدمة.

هام: بناءً على حجم التخزين لديك، تجنب تعيين هذه القيمة على قيمة عالية جداً، ما قد يؤثر سلباً على التخزين والأداء.

تشغيل التزامن

تعمل الإعدادات التالية فقط مع مهام سير العمل التي تبدأ بمشغل يستند إلى التكرار للموصلات المضمنة المستندة إلى موفر الخدمة. بالنسبة لسير عمل يبدأ بمشغل يستند إلى دالة، قد تحاول إعداد الإرسال في دفعات حيثما كان مدعوما. ومع ذلك، فإن الإرسال في دفعات ليس دائما الحل الصحيح. على سبيل المثال، مع مشغلات ناقل خدمة Azure، قد تحتفظ الدفعة بالرسائل بعد مدة التأمين. ونتيجة لذلك، يفشل أي إجراء، مثل الإكمال أو التخلي، في مثل هذه الرسائل.

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Trigger.MaximumRunConcurrency 100 أشواط يضبط الحد الأقصى لعدد عمليات التشغيل المتزامنة التي يمكن أن يبدأها المشغل. تظهر هذه القيمة في تعريف التزامن المشغل.
Runtime.Trigger.MaximumWaitingRuns 200 أشواط يعيّن الحد الأقصى لعدد عمليات التشغيل التي يمكن أن تنتظر بعد تلبية عمليات التشغيل المتزامنة للحد الأقصى. تظهر هذه القيمة في تعريف التزامن المشغل. لمزيد من المعلومات، راجع تغيير حد تشغيل الانتظار.

مدة التشغيل واستبقاء المحفوظات

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.FlowRunTimeout 90.00:00:00
(90 يوماً)
يضبط مقدار الوقت الذي يمكن أن يستمر فيه سير العمل في العمل قبل فرض انتهاء المهلة. الحد الأدنى لقيمة هذا الإعداد هو 7 أيام.

هام: تأكد من أن هذه القيمة أقل من أو تساوي قيمة إعداد التطبيق المسمى Workflows.RuntimeConfiguration.RetentionInDays. خلاف ذلك، يمكن حذف سجلات التشغيل قبل اكتمال المهام المرتبطة.
Runtime.FlowMaintenanceJob.RetentionCooldownInterval 7.00:00:00
(7 أيام)
تعيين مقدار الوقت بالأيام كفاصل زمني بين وقت التحقق من محفوظات التشغيل التي لم تعد تريد الاحتفاظ بها وحذفها.

قم بتشغيل الإجراءات

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout 00:10:00
(10 دقيقة)
يعيّن مقدار الوقت الذي تستغرقه مهمة إجراء سير العمل للتشغيل قبل انتهاء المهلة وإعادة المحاولة.

المدخلات والمخرجات

الإعدادات القيمة الافتراضية ‏‏الوصف
Microsoft.Azure.Workflows.TemplateLimits.InputParametersLimit 50 قم بتغيير الحد الافتراضي لمعلمات سير العمل عبر البيئة حتى 500 لتطبيقات المنطق القياسية التي تم إنشاؤها عن طريق تصدير تطبيقات منطق الاستهلاك.
Runtime.ContentLink.MaximumContentSizeInBytes 104857600 بايت تعيين الحد الأقصى للحجم بالبايت الذي يمكن أن يحتوي عليه الإدخال أو الإخراج في مشغل أو إجراء واحد.
Runtime.FlowRunActionJob.MaximumActionResultSize 209715200 بايت تعيين الحد الأقصى للحجم بالبايت الذي يمكن أن تحتوي عليه المدخلات والمخرجات المجمعة في إجراء واحد.

فصل الصفحات

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.FlowRunRetryableActionJobCallback.MaximumPageCount صفحات 1000 عندما يتم دعم ترقيم الصفحات وتمكينه في إحدى العمليات، يعيّن الحد الأقصى لعدد الصفحات التي سيتم إرجاعها أو معالجتها في وقت التشغيل.

التقسيم

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.FlowRunRetryableActionJobCallback.MaximumContentLengthInBytesForPartialContent 1073741824 بايت عند دعم التقسيم وتمكينه في إحدى العمليات، يعيّن الحد الأقصى للحجم بالبايت للمحتوى الذي تم تنزيله أو تحميله.
Runtime.FlowRunRetryableActionJobCallback.MaxChunkSizeInBytes 52428800 بايت عند دعم التقسيم وتمكينه في إحدى العمليات، يعيِّن الحد الأقصى للحجم بالبايت لكل مقطع محتوى.
Runtime.FlowRunRetryableActionJobCallback.MaximumRequestCountForPartialContent 1000 من الطلبات عند دعم التقسيم وتمكينه في إحدى العمليات، يعيّن الحد الأقصى لعدد الطلبات التي يمكن أن يقوم بها تنفيذ إجراء لتنزيل المحتوى.

تخزين المحتوى مضمنة أو استخدام النقط

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.FlowRunEngine.ForeachMaximumItemsForContentInlining 20 من العناصر عند تشغيل حلقة For each، يتم تخزين قيمة كل عنصر إما سطرياً مع بيانات التعريف الأخرى في تخزين الجدول أو بشكل منفصل في تخزين البيانات الثنائية الكبيرة. يضبط عدد العناصر المراد تخزينها بشكل مضمّن مع البيانات الأولية الأخرى.
Runtime.FlowRunRetryableActionJobCallback.MaximumPagesForContentInlining صفحات 20 يضبط الحد الأقصى لعدد الصفحات المراد تخزينها كمحتوى مضمن في تخزين الجدول قبل تخزينها في تخزين كائن ثنائي كبير الحجم (blob).
Runtime.FlowTriggerSplitOnJob.MaximumItemsForContentInlining 40 من العناصر عندما يقوم الإعداد SplitOn بتصحيح عناصر الصفيف في مثيلات سير عمل متعددة، يتم تخزين قيمة كل عنصر إما بشكل مضمن مع بيانات التعريف الأخرى في تخزين الجدول أو بشكل منفصل في تخزين كائن ثنائي كبير الحجم (blob). يضبط عدد العناصر المراد تخزينها مضمنة.
Runtime.ScaleUnit.MaximumCharactersForContentInlining 8192 حرفاً يضبط الحد الأقصى لعدد أحرف الإدخال والإخراج للعملية لتخزينها بشكل مضمن في وحدة تخزين الجدول قبل التخزين في تخزين البيانات الثنائية الكبيرة.

لكل حلقات

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.FlowDefaultForeachItemsLimit عناصر الصفيف 100000 بالنسبة إلى سير العمل ذي الحالة، يعيّن الحد الأقصى لعدد عناصر الصفيف المراد معالجتها في حلقة For each.
Runtime.Backend.FlowDefaultSplitOnItemsLimit عناصر الصفيف 100000 يعيّن الحد الأقصى لعدد عناصر الصفيف المراد تصحيحها أو تقسيمها إلى مثيلات سير عمل متعددة بناءً على الإعداد SplitOn.
Runtime.Backend.ForeachDefaultDegreeOfParallelism تكرارات 20 يعيّن العدد الافتراضي للتكرارات المتزامنة، أو درجة التوازي، في حلقة For each. للتشغيل بالتتابع، اضبط القيمة على 1.
Runtime.Backend.Stateless.FlowDefaultForeachItemsLimit 100 من العناصر بالنسبة إلى سير العمل عديم الحالة، يعيّن الحد الأقصى لعدد عناصر الصفيف المراد معالجتها في حلقة For each.

حتى الحلقات

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.MaximumUntilLimitCount تكرارات 5000 بالنسبة إلى stateful workflow، قم بتعيين أقصى عدد ممكن للخاصية Count في إجراء Until.
Runtime.Backend.Stateless.FlowRunTimeout 00:05:00
(5 دقائق)
يضبط الحد الأقصى لوقت الانتظار لحلقة Until في سير عمل عديم الحالة.
Runtime.Backend.Stateless.MaximumUntilLimitCount تكرارات 100 في stateless workflow، قم بتعيين أقصى عدد ممكن للخاصية Count في إجراء Until.

المتغيرات

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.DefaultAppendArrayItemsLimit عناصر الصفيف 100000 يضبط الحد الأقصى لعدد العناصر في متغير بنوع الصفيف.
Runtime.Backend.VariableOperation.MaximumStatelessVariableSize سير العمل عديم الحالة: 1024 حرف يضبط الحد الأقصى للحجم بالأحرف للمحتوى الذي يمكن للمتغير تخزينه عند استخدامه في سير عمل عديم الحالة.
Runtime.Backend.VariableOperation.MaximumVariableSize سير العمل ذو الحالة: 104857600 حرفاً يعيّن الحد الأقصى للحجم بالأحرف للمحتوى الذي يمكن للمتغير تخزينه عند استخدامه في سير عمل ذي حالة.

عمليات HTTP المضمنة

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.HttpOperation.DefaultRetryCount 4 يعيد المحاولة يضبط عدد مرات إعادة المحاولة الافتراضي لمشغلات وإجراءات HTTP.
Runtime.Backend.HttpOperation.DefaultRetryInterval 00:00:07
(7 ثانية)
يضبط الفاصل الزمني الافتراضي لإعادة المحاولة لمشغلات وإجراءات HTTP.
Runtime.Backend.HttpOperation.DefaultRetryMaximumInterval 01:00:00
(1 ساعة)
يضبط الحد الأقصى للفاصل الزمني لإعادة المحاولة لمشغلات وإجراءات HTTP.
Runtime.Backend.HttpOperation.DefaultRetryMinimumInterval 00:00:05
(5 ثانية)
يضبط الحد الأدنى للفاصل الزمني لإعادة المحاولة لمشغلات وإجراءات HTTP.
Runtime.Backend.HttpOperation.MaxContentSize 104857600 بايت تعيين الحد الأقصى لحجم الطلب بالبايت لإجراءات HTTP فقط، وليس المشغلات. لمزيد من المعلومات، راجع القيود.
Runtime.Backend.HttpOperation.RequestTimeout 00:03:45
(3 دقائق و45 ثانية)

ملاحظة: القيمة الافتراضية هي أيضا القيمة القصوى.
يضبط قيمة مهلة الطلب لمشغلات وإجراءات HTTP.

عمليات HTTP Webhook المضمنة

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.HttpWebhookOperation.DefaultRetryCount 4 يعيد المحاولة يعيّن عدد مرات إعادة المحاولة الافتراضي لمشغلات وإجراءات HTTP webhook.
Runtime.Backend.HttpWebhookOperation.DefaultRetryInterval 00:00:07
(7 ثانية)
يعيّن الفاصل الزمني الافتراضي لإعادة المحاولة لمشغلات وإجراءات خطاف الويب HTTP.
Runtime.Backend.HttpWebhookOperation.DefaultRetryMaximumInterval 01:00:00
(1 ساعة)
يضبط الحد الأقصى للفاصل الزمني لإعادة المحاولة لمشغلات وإجراءات خطاف الويب HTTP.
Runtime.Backend.HttpWebhookOperation.DefaultRetryMinimumInterval 00:00:05
(5 ثانية)
يعيّن الحد الأدنى للفاصل الزمني لإعادة المحاولة لمشغلات وإجراءات خطاف الويب HTTP.
Runtime.Backend.HttpWebhookOperation.DefaultWakeUpInterval 01:00:00
(1 ساعة)
يعيّن الفاصل الزمني الافتراضي للتنبيه لمهام الخطاف والإجراء التي تؤدي إلى خطاف ويب HTTP.
Runtime.Backend.HttpWebhookOperation.MaxContentSize 104857600 بايت تعيين الحد الأقصى لحجم الطلب بالبايت لإجراءات HTTP webhook فقط، وليس المشغلات. لمزيد من المعلومات، راجع القيود.
Runtime.Backend.HttpWebhookOperation.RequestTimeout 00:02:00
(2 دقيقة)
يعيّن قيمة مهلة الطلب لمشغلات وإجراءات HTTP webhook.

عمليات تخزين Azure المضمنة

مساحة تخزين Blob

الإعدادات القيمة الافتراضية الوصف
Microsoft.Azure.Workflows.ContentStorage.RequestOptionsThreadCount بلا تعيين عدد مؤشرات الترابط لعمليات تحميل وتنزيل كائن ثنائي كبير الحجم. يمكنك استخدام هذا الإعداد لفرض وقت تشغيل Azure Logic Apps لاستخدام مؤشرات ترابط متعددة عند تحميل المحتوى وتنزيله من مدخلات ومخرجات الإجراء.
Runtime.ContentStorage.RequestOptionsDeltaBackoff 00:00:02
(2 ثانية)
يضبط الفاصل الزمني للتراجع بين عمليات إعادة المحاولة المرسلة إلى تخزين البيانات الثنائية الكبيرة.
Runtime.ContentStorage.RequestOptionsMaximumAttempts 4 يعيد المحاولة يضبط الحد الأقصى لعدد المحاولات المرسلة إلى الجدول وتخزين قائمة الانتظار.
Runtime.ContentStorage.RequestOptionsMaximumExecutionTime 00:02:00
(2 دقيقة)
تعيين قيمة مهلة العملية، بما في ذلك إعادة المحاولة، لطلبات الكائن الثنائي كبير الحجم من وقت تشغيل Azure Logic Apps.
Runtime.ContentStorage.RequestOptionsServerTimeout 00:00:30
(30 ثانية)
يعيّن قيمة المهلة لطلبات البيانات الثنائية الكبيرة من وقت تشغيل Azure Logic Apps.

تخزين الجدول وقائمة الانتظار

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.DataStorage.RequestOptionsDeltaBackoff 00:00:02
(2 ثانية)
يضبط الفاصل الزمني للتراجع بين عمليات إعادة المحاولة المرسلة إلى الجدول وتخزين قائمة الانتظار.
Runtime.DataStorage.RequestOptionsMaximumAttempts 4 يعيد المحاولة يضبط الحد الأقصى لعدد المحاولات المرسلة إلى الجدول وتخزين قائمة الانتظار.
Runtime.DataStorage.RequestOptionsMaximumExecutionTime 00:00:45
(45 ثانية)
يعيّن قيمة مهلة العملية، بما في ذلك عمليات إعادة المحاولة، لطلبات تخزين الجدول وقائمة الانتظار من وقت تشغيل Azure Logic Apps.
Runtime.DataStorage.RequestOptionsServerTimeout 00:00:16
(16 ثانية)
يعيّن قيمة المهلة لطلبات تخزين الجدول وقائمة الانتظار من وقت تشغيل Azure Logic Apps.

مشاركة الملف

الإعدادات القيمة الافتراضية ‏‏الوصف
ServiceProviders.AzureFile.MaxFileSizeInBytes 150000000 بايت تعيين الحد الأقصى لحجم الملف بالبايت لمشاركة ملف Azure.

عمليات Azure Functions المضمنة

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.FunctionOperation.RequestTimeout 00:03:45
(3 دقائق و45 ثانية)
يعيّن قيمة مهلة الطلب لإجراءات Azure Functions.
Runtime.Backend.FunctionOperation.MaxContentSize 104857600 بايت يعيّن الحد الأقصى لحجم الطلب بالبايت لإجراءات Azure Functions. لمزيد من المعلومات، راجع القيود.
Runtime.Backend.FunctionOperation.DefaultRetryCount 4 يعيد المحاولة يعيّن عدد مرات إعادة المحاولة الافتراضي لإجراءات Azure Functions.
Runtime.Backend.FunctionOperation.DefaultRetryInterval 00:00:07
(7 ثانية)
يعيّن الفاصل الزمني الافتراضي لإعادة المحاولة لإجراءات Azure Functions.
Runtime.Backend.FunctionOperation.DefaultRetryMaximumInterval 01:00:00
(1 ساعة)
يعيّن الحد الأقصى للفاصل الزمني لإعادة المحاولة لإجراءات Azure Functions.
Runtime.Backend.FunctionOperation.DefaultRetryMinimumInterval 00:00:05
(5 ثانية)
يعيّن الحد الأدنى للفاصل الزمني لإعادة المحاولة لإجراءات Azure Functions.

عمليات ناقل خدمة Azure المضمنة

الإعدادات القيمة الافتراضية ‏‏الوصف
ServiceProviders.ServiceBus.MessageSenderOperationTimeout 00:01:00
(دقيقة)
يضبط مهلة إرسال الرسائل من خلال عملية ناقل خدمة Microsoft Azure المدمجة.
Runtime.ServiceProviders.ServiceBus.MessageSenderPoolSizePerProcessorCount 64 مرسلي الرسائل يعيّن عدد مرسلي رسائل Azure Service Bus لكل نواة معالج لاستخدامها في تجمع مرسلي الرسائل.

عمليات SFTP المضمنة

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.ServiceProviders.Sftp.MaxFileSizeInBytes 2147483648 بايت تعيين الحد الأقصى لحجم الملف بالبايت لإجراء الحصول على محتوى الملف (V2 ).
Runtime.ServiceProviders.Sftp.MaximumFileSizeToReadInBytes 209715200 بايت تعيين الحد الأقصى لحجم الملف بالبايت لإجراء الحصول على محتوى الملف. تأكد من أن هذه القيمة لا تتجاوز حجم الذاكرة القابلة للرجوع إليها لأن هذا الإجراء يقرأ محتوى الملف في الذاكرة.

عمليات الموصل المدارة

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.Backend.ApiConnectionOperation.RequestTimeout 00:02:00
(2 دقيقة)
يعيّن قيمة مهلة الطلب لمشغلات وإجراءات موصل واجهة برمجة التطبيقات المُدار.
Runtime.Backend.ApiConnectionOperation.MaxContentSize 104857600 بايت يضبط الحد الأقصى لحجم الطلب بالبايت لمشغلات وإجراءات موصل API المُدار. لمزيد من المعلومات، راجع القيود.
Runtime.Backend.ApiConnectionOperation.DefaultRetryCount 4 يعيد المحاولة يعيّن عدد مرات إعادة المحاولة الافتراضي لمشغلات وإجراءات موصل واجهة برمجة التطبيقات المُدار.
Runtime.Backend.ApiConnectionOperation.DefaultRetryInterval 00:00:07
(7 ثانية)
يضبط الفاصل الزمني الافتراضي لإعادة المحاولة لمشغلات وإجراءات موصل API المُدار.
Runtime.Backend.ApiWebhookOperation.DefaultRetryMaximumInterval 01:00:00
(يوم 1)
يعيّن الحد الأقصى للفاصل الزمني لإعادة المحاولة لمشغلات وإجراءات خطاف الويب لموصل واجهة برمجة التطبيقات المُدار.
Runtime.Backend.ApiConnectionOperation.DefaultRetryMinimumInterval 00:00:05
(5 ثانية)
يضبط الحد الأدنى للفاصل الزمني لإعادة المحاولة لمشغلات وإجراءات موصل واجهة برمجة التطبيقات (API) المُدار.
Runtime.Backend.ApiWebhookOperation.DefaultWakeUpInterval 01:00:00
(يوم 1)
يعيّن الفاصل الزمني الافتراضي للتنبيه لمهام مشغّل الخطاف على الويب وموصل واجهة برمجة التطبيقات المُدار ومهام الإجراءات.

نهج إعادة المحاولة لجميع العمليات الأخرى

الإعدادات القيمة الافتراضية ‏‏الوصف
Runtime.ScaleMonitor.MaxPollingLatency 00:00:30
(30 ثانية)
يعيّن الحد الأقصى لوقت استجابة الاقتراع لقياس وقت التشغيل.
Runtime.Backend.Operation.MaximumRetryCount 90 يعيد المحاولة يعيّن الحد الأقصى لعدد المحاولات في تعريف نهج إعادة المحاولة لعملية سير العمل.
Runtime.Backend.Operation.MaximumRetryInterval 01:00:00:01
(يوم واحد وثانية واحدة)
يعيّن الحد الأقصى للفاصل الزمني في تعريف نهج إعادة المحاولة لعملية سير العمل.
Runtime.Backend.Operation.MinimumRetryInterval 00:00:05
(5 ثانية)
يعيّن الحد الأدنى للفاصل الزمني في تعريف نهج إعادة المحاولة لعملية سير العمل.

القيود

  • الحد الأقصى لحجم المحتوى

    بشكل افتراضي، تقتصر المشغلات المضمنة، مثل HTTP أو الطلب، على حجم الرسالة الموضحة في الحدود ومرجع التكوين - الرسائل. لمعالجة الملفات الأكبر من الحد الأقصى، حاول تحميل المحتوى الخاص بك ككائن ثنائي كبير الحجم إلى Azure Blob Storage، ثم احصل على المحتوى الخاص بك باستخدام موصل Azure Blob.

إدارة إعدادات المضيف - host.json

يمكنك إضافة أو تحديث أو حذف إعدادات المضيف، والتي تحدد إعدادات وقيم تكوين وقت التشغيل التي تنطبق على جميع مهام سير العمل في هذا التطبيق المنطقي، مثل القيم الافتراضية للمعدل نقل والسعة وحجم البيانات وما إلى ذلك قيد التشغيل، سواء كانت تعمل محلياً أو في Azure. بالنسبة لإعدادات المضيف الخاصة بالتطبيقات المنطقية، راجع الدليل المرجعي لإعدادات التشغيل والتوزيع المتاحة - host.json.

مدخل Microsoft Azure - host.json

لمراجعة إعدادات المضيف للتطبيق المنطقي المستند إلى المستأجر الفردي في مدخل Microsoft Azure، اتبع الخطوات التالية:

  1. في مربع البحث مدخل Microsoft Azure، ابحث عن التطبيق المنطقي وافتحه.

  2. في قائمة تطبيق المنطق، ضمن أدوات التطوير، حدد أدوات متقدمة.

  3. في صفحة Advanced Tools، حدد Go، والتي تفتح بيئة Kudu لتطبيقك المنطقي.

  4. في شريط أدوات Kudu، من قائمة وحدة التحكم في تصحيح الأخطاء، حدد CMD.

  5. في مدخل Microsoft Azure، افتح تطبيق المنطق الخاص بك.

    1. من قائمة تطبيقك المنطقي، اختر Overview.

    2. في شريط أدوات جزء النظرة العامة، حدد إيقاف.

  6. في قائمة تطبيق المنطق، ضمن أدوات التطوير، حدد أدوات متقدمة.

  7. في جزء Advanced Tools، حدد Go، الذي يفتح بيئة Kudu لتطبيق المنطق الخاص بك.

  8. في شريط أدوات Kudu، افتح قائمة وحدة تحكم تتبع الأخطاء، وحدد CMD.

    تفتح نافذة وحدة التحكم بحيث يمكنك الاستعراض للوصول إلى المجلد wwwroot باستخدام موجه الأوامر. أو يمكنك استعراض بنية الدليل التي تظهر أعلى نافذة وحدة التحكم.

  9. تصفح عبر المسار التالي إلى المجلد wwwroot : ...\home\site\wwwroot.

  10. أعلى نافذة وحدة التحكم، في جدول الدليل، بجوار ملف host.json، حدد Edit.

  11. بعد فتح ملف host.json، راجع أي إعدادات مضيف تمت إضافتها مسبقاً لتطبيق المنطق.

    لمزيد من المعلومات بشأن إعدادات المضيف، راجع الدليل المرجعي لإعدادات المضيف المتاحة - host.json.

لإضافة إعداد، اتبع الخطوات التالية:

  1. قبل إضافة الإعدادات أو تحريرها، أوقف التطبيق المنطقي في مدخل Microsoft Azure.

    1. من قائمة تطبيقك المنطقي، اختر Overview.
    2. في شريط أدوات جزء النظرة العامة، حدد إيقاف.
  2. ارجع إلى ملف host.json. ضمن العنصر extensionBundle، أضف العنصر extensions، الذي يتضمن عنصرين workflow وsettings، على سبيل المثال:

    {
       "version": "2.0",
       "extensionBundle": {
          "id": "Microsoft.Azure.Functions.ExtensionBundle",
          "version": "[1.*, 2.0.0)"
       },
       "extensions": {
          "workflow": {
             "settings": {
             }
          }
       }
    }
    
  3. في العنصر settings، أضف قائمة مسطحة بإعدادات المضيف التي تريد استخدامها لجميع مهام سير العمل في التطبيق المنطقي الخاص بك، سواء كانت مهام سير العمل هذه تعمل محلياً أو في Azure، على سبيل المثال:

    {
       "version": "2.0",
       "extensionBundle": {
          "id": "Microsoft.Azure.Functions.ExtensionBundle",
          "version": "[1.*, 2.0.0)"
       },
       "extensions": {
          "workflow": {
             "settings": {
                "Runtime.Trigger.MaximumWaitingRuns": "100"
             }
          }
       }
    }
    
  4. عند الانتهاء، تذكر تحديد Save.

  5. الآن، أعد تشغيل تطبيق المنطق. ارجع إلى صفحة Overview لتطبيقك، وحدد Restart.

Visual Studio Code - host.json

لمراجعة إعدادات المضيف لتطبيقك المنطقي في Visual Studio Code، اتبع الخطوات التالية:

  1. في مشروع التطبيق المنطقي، على مستوى المشروع الأساسي، ابحث عن ملف host.json وافتحه.

  2. في العنصر extensions، ضمن workflows وsettings، راجع أي إعدادات مضيف تمت إضافتها مسبقاً لتطبيق المنطق. وإلا فلن يظهر العنصر extensions في الملف.

    لمزيد من المعلومات بشأن إعدادات المضيف، راجع الدليل المرجعي لإعدادات المضيف المتاحة - host.json.

لإضافة إعداد مضيف، اتبع الخطوات التالية:

  1. في ملف host.json، ضمن العنصر extensionBundle، أضف العنصر extensions، الذي يتضمن العنصرين workflow وsettings، على سبيل المثال:

    {
       "version": "2.0",
       "extensionBundle": {
          "id": "Microsoft.Azure.Functions.ExtensionBundle",
          "version": "[1.*, 2.0.0)"
       },
       "extensions": {
          "workflow": {
             "settings": {
             }
          }
       }
    }
    
  2. في العنصر settings، أضف قائمة مسطحة بإعدادات المضيف التي تريد استخدامها لجميع مهام سير العمل في التطبيق المنطقي الخاص بك، سواء كانت مهام سير العمل هذه تعمل محلياً أو في Azure، على سبيل المثال:

    {
       "version": "2.0",
       "extensionBundle": {
          "id": "Microsoft.Azure.Functions.ExtensionBundle",
          "version": "[1.*, 2.0.0)"
       },
       "extensions": {
          "workflow": {
             "settings": {
                "Runtime.Trigger.MaximumWaitingRuns": "100"
             }
          }
       }
    }
    

الخطوات التالية