تشغيل ملف على نظام مجموعة أو ملف أو دفتر ملاحظات كوظيفة في Azure Databricks باستخدام ملحق Databricks ل Visual Studio Code

يسمح لك ملحق Databricks ل Visual Studio Code بتشغيل تعليمة Python البرمجية الخاصة بك على نظام مجموعة أو تعليمة Python أو R أو Scala أو SQL البرمجية أو دفتر الملاحظات كوظيفة في Azure Databricks.

تفترض هذه المعلومات أنك قمت بالفعل بتثبيت وإعداد ملحق Databricks ل Visual Studio Code. راجع تثبيت ملحق Databricks ل Visual Studio Code.

إشعار

لتصحيح أخطاء التعليمات البرمجية أو دفاتر الملاحظات من داخل Visual Studio Code، استخدم Databricks Connect. راجع تصحيح التعليمات البرمجية باستخدام Databricks Connect لملحق Databricks ل Visual Studio Code وتشغيل خلايا دفتر الملاحظات وتصحيحها باستخدام Databricks Connect باستخدام ملحق Databricks ل Visual Studio Code.

تشغيل ملف Python على نظام مجموعة

لتشغيل ملف Python على نظام مجموعة Azure Databricks باستخدام ملحق Databricks ل Visual Studio Code، مع الملحق وفتح مشروعك:

1. افتح ملف Python الذي تريد تشغيله على نظام المجموعة.
2. قم بأحد الإجراءات التالية:

   • في شريط عنوان محرر الملفات، انقر فوق الأيقونة تشغيل على Databricks ، ثم انقر فوق تحميل الملف وتشغيله.

     

   • في طريقة عرض المستكشف (View > Explorer)، انقر بزر الماوس الأيمن فوق الملف، ثم حدد Run on Databricks>Upload and Run File من قائمة السياق.

     

يتم تشغيل الملف على نظام المجموعة، ويتوفر الإخراج في وحدة تحكم تتبع الأخطاء (عرض > وحدة تحكم تتبع الأخطاء).

تشغيل ملف Python كوظيفة

لتشغيل ملف Python كمهمة Azure Databricks باستخدام ملحق Databricks ل Visual Studio Code، مع الملحق وفتح مشروعك:

1. افتح ملف Python الذي تريد تشغيله كوظيفة.
2. قم بأحد الإجراءات التالية:

   • في شريط عنوان محرر الملفات، انقر فوق الأيقونة تشغيل على Databricks ، ثم انقر فوق تشغيل الملف كسير عمل.

     

   • في طريقة عرض المستكشف (View > Explorer)، انقر بزر الماوس الأيمن فوق الملف، ثم حدد Run on Databricks>Run File as Workflow من قائمة السياق.

     

تظهر علامة تبويب محرر جديدة بعنوان Databricks Job Run. يتم تشغيل الملف كوظيفة في مساحة العمل، وتتم طباعة أي إخراج إلى منطقة الإخراج لعلامة تبويب المحرر الجديد.

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

تشغيل دفتر ملاحظات Python أو R أو Scala أو SQL كوظيفة

لتشغيل دفتر ملاحظات كمهمة Azure Databricks باستخدام ملحق Databricks ل Visual Studio Code، مع فتح الملحق ومشروعك:

1. افتح دفتر الملاحظات الذي تريد تشغيله كوظيفة.

   تلميح

   لتحويل ملف Python أو R أو Scala أو SQL إلى دفتر ملاحظات Azure Databricks، أضف التعليق # Databricks notebook source إلى بداية الملف، وأضف التعليق # COMMAND ---------- قبل كل خلية. لمزيد من المعلومات، راجع استيراد ملف وتحويله إلى دفتر ملاحظات.

   

2. قم بأحد الإجراءات التالية:

   • في شريط عنوان محرر ملفات دفتر الملاحظات، انقر فوق الأيقونة تشغيل على Databricks ، ثم انقر فوق تشغيل الملف كسير عمل.

   إشعار

   إذا لم يكن التشغيل على Databricks كسير عمل متوفرا، فشاهد إنشاء تكوين تشغيل مخصص.

   • في طريقة عرض المستكشف (View > Explorer)، انقر بزر الماوس الأيمن فوق ملف دفتر الملاحظات، ثم حدد Run on Databricks>Run File as Workflow من قائمة السياق.

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

لعرض معلومات حول تشغيل المهمة، انقر فوق ارتباط معرف تشغيل المهمة في علامة التبويب محرر تشغيل مهمة Databricks. يتم فتح مساحة العمل الخاصة بك ويتم عرض تفاصيل تشغيل الوظيفة في مساحة العمل.

إنشاء تكوين تشغيل مخصص

يسمح لك تكوين التشغيل المخصص لملحق Databricks ل Visual Studio Code بتمرير وسيطات مخصصة إلى مهمة أو دفتر ملاحظات، أو إنشاء إعدادات تشغيل مختلفة لملفات مختلفة.

لإنشاء تكوين تشغيل مخصص، انقر فوق تشغيل > إضافة تكوين من القائمة الرئيسية في Visual Studio Code. ثم حدد إما Databricks لتكوين تشغيل يستند إلى نظام المجموعة أو Databricks: سير العمل لتكوين تشغيل قائم على الوظيفة.

على سبيل المثال، يقوم تكوين التشغيل المخصص التالي بتعديل الأمر تشغيل ملف كسير عمل لتمرير الوسيطة --prod إلى المهمة:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "databricks-workflow",
      "request": "launch",
      "name": "Run on Databricks as Workflow",
      "program": "${file}",
      "parameters": {},
      "args": ["--prod"]
    }
  ]
}

تلميح

أضف "databricks": true إلى التكوين الخاص بك "type": "python" إذا كنت تريد استخدام تكوين Python ولكنك تستفيد من مصادقة Databricks Connect التي تعد جزءا من إعداد الملحق.

باستخدام تكوينات التشغيل المخصصة، يمكنك أيضا تمرير وسيطات سطر الأوامر وتشغيل التعليمات البرمجية الخاصة بك فقط عن طريق الضغط على F5. لمزيد من المعلومات، راجع تشغيل التكوينات في وثائق Visual Studio Code.