ما هو مرجع القيمة الديناميكية؟

تصف مراجع القيمة الديناميكية مجموعة من المتغيرات المتوفرة عند تكوين المهام والمهام. استخدم مراجع القيمة الديناميكية لتكوين عبارات شرطية للمهام أو لتمرير المعلومات كمعلمات أو وسيطات.

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

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

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

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

تستخدم مراجع القيم الديناميكية أقواسا متعرجة مزدوجة ({{ }}). عند تشغيل مهمة أو مهمة، تحل السلسلة الحرفية محل مرجع القيمة الديناميكية. على سبيل المثال، إذا قمت بتكوين زوج قيم المفاتيح التالي كمعلمة مهمة:

{"job_run_id": "job_{{job.run_id}}"}

إذا كان معرف التشغيل الخاص بك هو 550315892394120، يتم تقييم قيمة job_run_id إلى job_550315892394120.

إشعار

لا يتم تقييم محتويات الأقواس المتعرجة المزدوجة كتعبيرات. لا يمكنك تشغيل العمليات أو الوظائف في أقواس متعرجة مزدوجة.

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

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

استخدام مراجع القيمة الديناميكية في واجهة مستخدم الوظائف

توفر الحقول التي تقبل مراجع القيمة الديناميكية اختصارا لإدراج مراجع القيمة الديناميكية المتوفرة. انقر فوق { } لمشاهدة هذه القائمة وإدراجها في الحقل المتوفر.

إشعار

لا تكمل واجهة المستخدم المفاتيح تلقائيا للإشارة إلى قيم المهام.

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

استخدام مراجع القيمة الديناميكية في وظيفة JSON

استخدم {{ }} بناء الجملة لاستخدام القيم الديناميكية في تعريفات JSON للوظيفة المستخدمة من قبل Databricks CLI وواجهة برمجة تطبيقات REST.

معلمات المهمة والمهمة لها بناء جملة مختلف، ويختلف بناء جملة معلمة المهمة حسب نوع المهمة.

يوضح المثال التالي بناء جملة JSON الجزئي لتكوين معلمات المهمة باستخدام مراجع القيمة الديناميكية:

{
  "parameters": [
    {
      "name": "my_job_id",
      "default": "{{job.id}}"
    },
    {
      "name": "run_date",
      "default": "{{job.start_time.iso_date}}"
    }
  ]
}

يوضح المثال التالي بناء جملة JSON الجزئي لتكوين معلمات مهمة دفتر الملاحظات باستخدام مرجع قيمة ديناميكي:

{
  "notebook_task": {
    "base_parameters": {
      "workspace_id": "workspace_{{workspace.id}}",
      "file_arrival_location": "{{job.trigger.file_arrival.location}}"
    }
  }
}

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

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

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

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

المرجع	‏‏الوصف
{{job.id}}	المعرف الفريد المعين للوظيفة.
{{job.name}}	اسم الوظيفة في وقت تشغيل الوظيفة.
{{job.run_id}}	المعرف الفريد المعين لتشغيل المهمة.
{{job.repair_count}}	عدد محاولات الإصلاح في تشغيل المهمة الحالية.
{{job.start_time.<argument>}}	قيمة تستند إلى الوقت (في المنطقة الزمنية UTC) التي بدأ تشغيل المهمة فيها. تستند القيمة المرجعة إلى argument الخيار . راجع خيارات قيم التاريخ والوقت.
{{job.parameters.<name>}}	قيمة المعلمة على مستوى الوظيفة مع المفتاح <name>.
{{job.trigger.type}}	نوع المشغل لتشغيل المهمة. القيم المحتملة هي periodicو one_timerun_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 لمساحة العمل.

يمكنك تعيين هذه المراجع مع أي مهمة. راجع تكوين معلمات المهمة.

يمكنك أيضا تمرير المعلمات بين المهام في وظيفة بقيم المهام. راجع استخدام قيم المهام لتمرير المعلومات بين المهام.

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

استخدم الوسيطات التالية لتحديد القيمة المرجعة من متغيرات المعلمات المستندة إلى الوقت. تستند جميع قيم الإرجاع إلى طابع زمني في المنطقة الزمنية 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 بدلاً من ذلك.