مشاركة عبر

تحديد معلمات المهام

  • مقالة

توفر هذه المقالة نظرة عامة حول استخدام المعلمات مع الوظائف والمهام.

فيما يلي المفاهيم الأساسية لفهم معلمات الوظائف:

ماذا يمكنك أن تفعل مع المعلمات؟

أضف معلمات إلى الوظائف والمهام لحالات الاستخدام المتقدمة بما في ذلك ما يلي:

  • إضافة منطق قابل للتوسيع إلى أصول التعليمات البرمجية.
  • شرطية عمليات التشغيل.
  • الرجوع إلى المعلمات الشائعة عبر مهام متعددة.
  • استخدم المعلومات التي تم إنشاؤها في مهمة في مهمة أخرى.
  • بيانات التعريف المرجعية ومعلومات الحالة في تشغيل المهمة.

ما الفرق بين معلمات المهمة والمهمة؟

معلمات الوظيفة هي أزواج قيم المفاتيح المحددة على مستوى الوظيفة. يمكنك تجاوز الإعدادات الافتراضية لمعلمات الوظيفة عند التشغيل الآن بمعلمات مختلفة أو تشغيل مهمة باستخدام واجهة برمجة تطبيقات REST. يتم دفع معلمات الوظيفة لأسفل إلى المهام التي تستخدم معلمات قيمة المفتاح. يمكن للمهام الأخرى الرجوع إلى معلمات المهمة باستخدام مراجع القيمة الديناميكية.

معلمات المهمة هي أزواج قيم المفاتيح من صفائف JSON المعرفة على مستوى المهمة. يمرر كل نوع مهمة قيم المهمة إلى أصول التعليمات البرمجية المكونة بشكل مختلف. على سبيل المثال، تستخدم مهام دفتر الملاحظات dbutils.widgets النموذج الفرعي، بينما تمرر برامج Python النصية القيم كوسيطات إلى البرنامج النصي كما لو كان يتم استدعاؤه من سطر الأوامر. يمكن أن تشير مهام انتقال البيانات من الخادم إلى معلمات المهام من المهام الأولية باستخدام مراجع القيمة الديناميكية.

إشعار

لا تحتوي بعض المهام على حقل معلمات مخصص، ولكنها تسمح بالمراجع إلى قيم المهام أو مراجع القيم الديناميكية داخل حقول أخرى. راجع أمثلة أوامر dbt ذات المعلمات وإضافة منطق تفريع إلى مهمة باستخدام مهمة If/else.

إنشاء مهام سير العمل باستخدام القيم الديناميكية

يمكن تجاوز معلمات المهمة التي تم تعيينها بقيم ثابتة فقط عن طريق تحديث تعريف المهمة. تعيين قيمة ثابتة لمعلمة مهمة هو مجرد تكوين قيمة افتراضية، والتي يمكنك تجاوزها عند التشغيل الآن باستخدام معلمات مختلفة أو تشغيل مهمة باستخدام واجهة برمجة تطبيقات REST.

استخدم مراجع القيمة الديناميكية عند تعريف معلمات المهمة لتنفيذ أنماط مثل ما يلي:

  • استخدم معلمة وظيفة كمهمة output_table واحدة ولأخرى input_table .
  • التقط إخراج استعلام دفتر الملاحظات كلقائمة وقم بالتكرار فوقه في لكل مهمة.
  • إنشاء منطق نسخ استنادا إلى عدد السجلات التي تمت معالجتها باستخدام مهمة شرط If/else.
  • ارجع إلى معلمات من مهام أخرى.

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