تكوين معلمات المهمة
توضح هذه المقالة وظيفة معلمة الوظيفة وتكوين معلمات الوظيفة باستخدام واجهة مستخدم مساحة عمل Databricks. يمكنك أيضا إضافة معلمات الوظيفة إلى تعريفات JSON وYAML المستخدمة مع واجهة برمجة تطبيقات REST وCLI وDADBs. راجع واجهة برمجة تطبيقات الوظائف، وما هي Databricks CLI؟، وما هي حزم أصول Databricks؟.
ما هي معلمات الوظيفة؟
معلمات الوظيفة هي أزواج قيم المفاتيح التي تسمح لك بإضفاء معلمات على الوظائف بالقيم الثابتة أو الديناميكية الافتراضية. يمكنك اختياريا تجاوز المعلمات التي تم تكوينها في مهمة عند تشغيل تشغيل جديد. راجع تشغيل وظيفة بمعلمات مختلفة.
يمكن أن تحتوي مفاتيح معلمات الوظيفة على _ - . أحرف أبجدية رقمية فقط. يتم تعيين قيم المعلمات كسلاسل أو مراجع قيمة ديناميكية. راجع ما هو مرجع القيمة الديناميكية؟.
إشعار
يمكنك استخدام أي JSON صالح كقيمة معلمة. على سبيل المثال، For each يمكن لنوع المهمة تحليل القوائم مثل ما يلي:
[1, 2, 3]
['a', 'b', 'c']
إضافة معلمات مهمة أو تحريرها
استخدم مربع الحوار Job parameters لإضافة معلمات جديدة أو تحرير مفاتيح وقيم المعلمات الموجودة أو حذف المعلمات.
لتحرير المعلمات باستخدام واجهة مستخدم مساحة العمل، حدد مهمة موجودة باستخدام الخطوات التالية:
- انقر فوق
مهام سير العمل في الشريط الجانبي. - في العمود الاسم ، انقر فوق اسم المهمة.
- في الشريط الجانبي تفاصيل المهمة، انقر فوق تحرير المعلمات. يظهر مربع الحوار Job parameters.
- إضافة معلمات أو تحريرها باستخدام حقلي المفتاح والقيمة.
انقر فوق لإزالة معلمة.- حدد حفظ لتطبيق تغييراتك.
إشعار
انقر فوق { } لسرد مراجع القيمة الديناميكية المتوفرة. حدد خيارا من القائمة لإدراجه في حقل القيمة .
دفع معلمة الوظيفة لأسفل
يتم دفع معلمات المهمة تلقائيا كمعلمات قيمة المفتاح إلى جميع المهام التي تقبل معلمات قيمة المفتاح، والتي تتضمن أنواع المهام التالية:
- دفتر
- عجلة Python (فقط عند تكوينها باستخدام وسيطات الكلمة الأساسية)
- استعلام SQL أو لوحة معلومات قديمة أو ملف
- تشغيل المهمة
معلمات المهمة التي تم تمريرها إلى المهام مرئية في تكوين المهمة في واجهة المستخدم جنبا إلى جنب مع معلمات المهمة المكونة.
هام
معلمات الوظيفة لها الأسبقية على معلمات المهمة. إذا كانت معلمة مهمة ومعلمة مهمة لها نفس المفتاح، فإن معلمة الوظيفة تتجاوز معلمة المهمة.
مراجع القيمة الديناميكية لمعلمات الوظيفة
يمكن لجميع المهام التي تقبل مراجع القيمة الديناميكية الوصول إلى معلمات الوظيفة.
استخدم مرجع {{job.parameters.<name>}}القيمة الديناميكية ، واستبدل <name> ب key الذي يحدد المعلمة .
تشغيل وظيفة بمعلمات مختلفة
يمكنك تجاوز معلمات الوظيفة المكونة أو إضافة معلمات جديدة عند تشغيل وظيفة بمعلمات مختلفة. راجع تشغيل وظيفة بمعلمات مختلفة.
يمكنك أيضا تجاوز معلمات الوظيفة عند إصلاح تشغيل وظيفة. راجع إعادة تشغيل المهام الفاشلة والمهام التي تم تخطيها.