تمرير سياق حول المهمة التي يتم تشغيلها في مهام الوظيفة

يمكنك استخدام مراجع القيمة الديناميكية لتمرير سياق حول مهمة أو تشغيل مهمة مثل الوظيفة أو اسم المهمة أو معرف التشغيل أو وقت بدء تشغيل المهمة. مراجع القيمة الديناميكية هي متغيرات قالب يتم استبدالها بالقيم المناسبة عند تشغيل مهمة الوظيفة. عند تشغيل مهمة، يتم استبدال متغير معلمة المهمة محاطا بأقواس متعرجة مزدوجة وإلحاقه بقيمة سلسلة اختيارية مضمنة كجزء من القيمة. على سبيل المثال، لتمرير معلمة باسم MyJobId بقيمة my-job-6 لأي تشغيل لمعرف المهمة 6، أضف معلمة المهمة التالية:

{
  "MyJobID": "my-job-{{job.id}}"
}

لا يتم تقييم محتويات الأقواس المتعرجة المزدوجة كتعبيرات، لذلك لا يمكنك إجراء عمليات أو وظائف في أقواس متعرجة مزدوجة.

يجب إلغاء المعرفات التي يوفرها المستخدم، على سبيل المثال، أسماء المهام أو مفاتيح قيمة المهمة أو أسماء معلمات الوظيفة التي تحتوي على أحرف خاصة عن طريق إحاطة المعرفات بخلفيات (` `). يمكن استخدام الأحرف الأبجدية الرقمية والتسطير السفلي فقط دون الهروب.

{
  "VariableWithSpecialChars": "{{job.parameters.`param$@`}}"
}

يتم تجاهل أخطاء بناء الجملة في المراجع (على سبيل المثال، قوس مفقود) ويتم التعامل مع القيمة كسلسلة حرفية. على سبيل المثال، {{my.value} يتم تمرير كسلسلة "{{my.value}". ومع ذلك، لا يسمح بإدخال مرجع غير صالح ينتمي إلى مساحة اسم معروفة (على سبيل المثال، {{job.naem}}). يتم عرض رسالة خطأ إذا تم إدخال مرجع غير صالح ينتمي إلى مساحة اسم معروفة في واجهة المستخدم.

بعد اكتمال مهمة، يمكنك مشاهدة القيم التي تم حلها للمعلمات ضمن المعلمات في صفحة تفاصيل التشغيل.

مراجع القيمة المدعومة

يتم دعم مراجع القيمة الديناميكية التالية:

المرجع	‏‏الوصف
{{job.id}}	المعرف الفريد المعين للوظيفة.
{{job.name}}	اسم الوظيفة في وقت تشغيل الوظيفة.
{{job.run_id}}	المعرف الفريد المعين لتشغيل المهمة.
{{job.repair_count}}	عدد محاولات الإصلاح في تشغيل المهمة الحالية.
{{job.start_time.[argument]}}	قيمة تستند إلى الوقت (في المنطقة الزمنية UTC) التي بدأ تشغيل المهمة فيها. تستند القيمة المرجعة إلى argument الخيار . راجع خيارات قيم التاريخ والوقت.
{{job.parameters.[name]}}	قيمة المعلمة على مستوى الوظيفة مع المفتاح [name].
{{job.trigger.type}}	نوع المشغل لتشغيل المهمة. القيم المحتملة هي periodicو onetimerun_job_taskوfile_arrivalcontinuous.table
{{job.trigger.file_arrival.location}}	إذا تم تكوين مشغل وصول ملف لهذه المهمة، فقيمة موقع التخزين.
{{job.trigger.time.[argument]}}	قيمة تستند إلى الوقت (في المنطقة الزمنية UTC) الذي تم تشغيل تشغيل الوظيفة فيه، تم تقريبها إلى أقرب دقيقة للوظائف ذات جدول cron. تستند القيمة المرجعة إلى argument الخيار . راجع خيارات قيم التاريخ والوقت.
{{task.name}}	اسم المهمة الحالية.
{{task.run_id}}	المعرف الفريد لتشغيل المهمة الحالية.
{{task.execution_count}}	عدد المرات التي تم فيها تشغيل المهمة الحالية (بما في ذلك عمليات إعادة المحاولة والإصلاحات).
{{task.notebook_path}}	مسار دفتر الملاحظات لمهمة دفتر الملاحظات الحالية.
{{tasks.[task_name].run_id}}	يتم تشغيل المعرف الفريد المعين للمهمة ل [task_name].
{{tasks.[task_name].result_state}}	حالة النتيجة للمهمة [task_name]. والقيم المحتملة هي success وfailed وexcluded وcanceled وevicted وtimedout وupstream_canceled وupstream_evicted وupstream_failed.
{{tasks.[task_name].error_code}}	رمز الخطأ للمهمة [task_name] إذا حدث خطأ أثناء تشغيل المهمة. أمثلة على القيم المحتملة هي RunExecutionErrorو ResourceNotFoundو.UnauthorizedError للمهام الناجحة، يتم تقييم هذا إلى سلسلة فارغة.
{{tasks.[task_name].execution_count}}	عدد المرات التي تم فيها تشغيل المهمة [task_name] (بما في ذلك عمليات إعادة المحاولة والإصلاحات).
{{tasks.[task_name].notebook_path}}	المسار إلى دفتر الملاحظات لمهمة [task_name]دفتر الملاحظات .
{{tasks.[task_name].values.[value_name]}}	قيمة المهمة مع المفتاح [value_name] الذي تم تعيينه حسب المهمة [task_name].
{{workspace.id}}	المعرف الفريد المعين لمساحة العمل.
{{workspace.url}}	عنوان URL لمساحة العمل.

يمكنك تعيين هذه المراجع مع أي مهمة عند إنشاء مهمة أو تحرير مهمة أو تشغيل وظيفة بمعلمات مختلفة.

يمكنك أيضا تمرير المعلمات بين المهام في وظيفة بقيم المهام. راجع مشاركة المعلومات بين المهام في مهمة Azure Databricks.

خيارات قيم التاريخ والوقت

استخدم الوسيطات التالية لتحديد القيمة المرجعة من متغيرات المعلمات المستندة إلى الوقت. تستند جميع القيم المرجعة إلى طابع زمني في المنطقة الزمنية UTC.

الوسيطة	‏‏الوصف
iso_weekday	إرجاع رقم من 1 إلى 7، يمثل يوم الأسبوع من الطابع الزمني.
is_weekday	إرجاع true إذا كان الطابع الزمني في يوم من أيام الأسبوع.
iso_date	إرجاع التاريخ بتنسيق ISO.
iso_datetime	إرجاع التاريخ والوقت بتنسيق ISO.
year	إرجاع جزء السنة من الطابع الزمني.
month	إرجاع جزء الشهر من الطابع الزمني.
day	إرجاع جزء اليوم من الطابع الزمني.
hour	إرجاع جزء الساعة من الطابع الزمني.
minute	إرجاع جزء الدقيقة من الطابع الزمني.
second	إرجاع الجزء الثاني من الطابع الزمني.
timestamp_ms	إرجاع الطابع الزمني بالمللي ثانية.

متغيرات المعلمات المهملة

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

المتغير	‏‏الوصف
{{job_id}}	المعرف الفريد المعين لوظيفة. استخدم job.id بدلاً من ذلك.
{{run_id}}	المعرف الفريد المعين لتشغيل مهمة. استخدم task.run_id بدلاً من ذلك.
{{start_date}}	تاريخ بدء تشغيل المهمة. التنسيق هو yyyy-MM-dd في المنطقة الزمنية UTC. استخدم job.start_time.[argument] بدلاً من ذلك.
{{start_time}}	الطابع الزمني لبدء تشغيل التنفيذ بعد إنشاء نظام المجموعة وجاهز. التنسيق هو مللي ثانية منذ فترة UNIX في المنطقة الزمنية UTC، كما تم إرجاعه بواسطة System.currentTimeMillis(). استخدم job.start_time.[format] بدلاً من ذلك.
{{task_retry_count}}	عدد مرات إعادة المحاولة التي تمت محاولة تشغيل مهمة إذا فشلت المحاولة الأولى. القيمة هي 0 للمحاولة الأولى وتتزايد مع كل إعادة محاولة. استخدم task.execution_count بدلاً من ذلك.
{{parent_run_id}}	المعرف الفريد المعين لتشغيل مهمة ذات مهام متعددة. استخدم job.run_id بدلاً من ذلك.
{{task_key}}	الاسم الفريد المعين لمهمة تشكل جزءا من مهمة ذات مهام متعددة. استخدم task.name بدلاً من ذلك.