تطوير تطبيقات Databricks

هام

تطبيقات Databricks في المعاينة العامة.

إشعار

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

تحتوي هذه المقالة على تفاصيل حول إنشاء البيانات والتطبيقات الذكاء الاصطناعي باستخدام Databricks Apps، بما في ذلك كيفية إنشاء التطبيقات وتحريرها في واجهة المستخدم، وكيفية استخدام ميزات النظام الأساسي Databricks مثل مستودعات SQL والأسرار ووظائف Databricks وأفضل الممارسات لتطوير تطبيقاتك والمعلومات المهمة لتطوير التطبيقات باستخدام أطر العمل المدعومة.

كيف أعمل إنشاء تطبيق في واجهة مستخدم تطبيقات Databricks؟

1. في الشريط الجانبي، انقر فوق جديد وحدد تطبيق من القائمة.

2. يمكنك البدء بتطبيق مثال كامل تم إنشاؤه مسبقا أو استخدام التعليمات البرمجية المصدر والبيانات الاصطناعية.

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

   

3. انقر فوق التالي.

4. في حقل اسم التطبيق، أدخل اسما للتطبيق وأدخل وصفا اختياريا.

   إشعار

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

   

   إذا حددت مخصص، فانقر فوق إنشاء تطبيق. إذا حددت Template، فكون الموارد المطلوبة وانقر فوق Create and deploy app. راجع تعيين ميزات النظام الأساسي Databricks لتطبيق Databricks.

   

   تظهر صفحة تفاصيل التطبيق بعد النقر فوق إنشاء تطبيق ونشره أو إنشاء تطبيق. إذا حددت Template، فإن Databricks Apps تنشئ تطبيقك ثم تنشر التطبيق، بما في ذلك مثال التعليمات البرمجية من القالب والتكوين المطلوب للتطبيق. تظهر صفحة التفاصيل للتطبيق ما يلي:

   • حالة إنشاء التطبيق ونشره.
   • الخطوات التي يمكنك استخدامها لمتابعة تطوير التطبيق محليا، بما في ذلك نسخ البيانات الاصطناعية للتطبيق إلى بيئتك المحلية ومزامنة التغييرات المحلية مرة أخرى إلى مساحة عمل Azure Databricks.

   

   إذا حددت Custom، فإن Databricks Apps تنشئ تطبيقك. نظرا لأنه يجب إضافة التعليمات البرمجية والبيانات الاصطناعية لتطبيقك، يجب نشر التطبيق كخطوة منفصلة. تظهر صفحة التفاصيل للتطبيق ما يلي:

   • حالة إنشاء التطبيق.
   • الخطوات التي يمكنك استخدامها لمزامنة التعليمات البرمجية للتطبيق والبيانات الاصطناعية من بيئة التطوير المحلية إلى مساحة عمل Azure Databricks ونشر التطبيق.

   

   لمعرفة كيفية إعداد بيئة تطوير محلية، قم بإنشاء أو تحديث التعليمات البرمجية والتكوين لتطبيقك محليا، ومزامنة التطبيق ونشره في مساحة عمل Azure Databricks، راجع بدء استخدام تطبيقات Databricks.

5. إذا حددت Template وأردت نسخ بيانات التطبيق الاصطناعية من مساحة العمل إلى بيئة التطوير المحلية، يمكنك استخدام Databricks CLI:

   databricks workspace export-dir <workspace-path> <target-path>
   

   استبدل:

   • <workspace-path> مع المسار إلى دليل ملفات مساحة العمل الذي يحتوي على التعليمات البرمجية للتطبيق والبيانات الاصطناعية.
   • <target-path> بمسار في البيئة المحلية لنسخ الملفات إليه.

تعيين ميزات النظام الأساسي Databricks لتطبيق Databricks

إشعار

لاستخدام Databricks SQL، تتطلب أساسيات الخدمة الوصول إلى مستودع SQL وأي جداول يتم الوصول إليها بواسطة الاستعلامات.

لاستخدام ميزات النظام الأساسي Databricks مثل Databricks SQL وDatabricks Jobs وSosasic الذكاء الاصطناعي Model Serving وأسرار Databricks، أضف هذه الميزات إلى تطبيقك كموارد. يمكنك إضافة موارد عند إنشاء تطبيق أو تحريره.

1. في بطاقة إنشاء تطبيق جديد أو تحرير التطبيق، انقر فوق إعدادات متقدمة>+ إضافة مورد، وحدد نوع المورد.

   

2. اعتمادا على نوع المورد، أكمل الحقول المطلوبة لتكوين المورد، بما في ذلك حقل مفتاح المورد. يتم استخدام هذا المفتاح لاحقا للإشارة إلى المورد.

3. انقر فوق حفظ.

4. إضافة إدخال للمورد في app.yaml ملف التكوين باستخدام مفتاح مورد مستودع SQL. نظرا لأن هذا يشير إلى مصدر قيمة المعلمة وليس القيمة الفعلية، استخدم valueFrom بدلا من value.

   env:
     - name: "DATABRICKS_WAREHOUSE_ID"
       valueFrom: "sql-warehouse"
   

5. للإشارة إلى المورد في التعليمات البرمجية للتطبيق، استخدم قيمة name الحقل (DATABRICKS_WAREHOUSE_ID في هذا المثال) للإشارة إلى قيمة المفتاح المكونة.

   import os
   
   os.getenv('DATABRICKS_WAREHOUSE_ID')
   

لمشاهدة المزيد من الأمثلة على استخدام الموارد مع التطبيقات، بما في ذلك مستودعات SQL ونقاط نهاية خدمة النموذج، راجع أمثلة القالب عند إنشاء تطبيق وأفضل الممارسات: استخدام البيانات السرية لتخزين المعلومات الحساسة لتطبيق Databricks.

عرض تفاصيل تطبيق Databricks

لعرض صفحة التفاصيل لتطبيق Databricks:

1. انقر فوق حساب في الشريط الجانبي.
2. انتقل إلى علامة التبويب التطبيقات .
3. في العمود الاسم ، انقر فوق اسم التطبيق.
4. تظهر علامة التبويب نظرة عامة مع تفاصيل التطبيق، بما في ذلك حالته وموقع النشر وأي موارد مرتبطة به.
   • للوصول إلى محفوظات نشر التطبيق، انتقل إلى علامة التبويب Deployments .
   • لعرض سجلات التطبيق، انتقل إلى علامة التبويب سجلات .
   • لعرض بيئة وقت التشغيل للتطبيق، بما في ذلك متغيرات البيئة والحزم المثبتة ، انتقل إلى علامة التبويب البيئة .

تكوين الأذونات لتطبيق Databricks

لإدارة أذونات التطبيق، يجب أن يكون لديك CAN MANAGE الإذن أو IS OWNER .

1. في صفحة تفاصيل التطبيق، انقر فوق أذونات.
2. في إعدادات الأذونات، حدد القائمة المنسدلة تحديد المستخدم أو المجموعة أو كيان الخدمة... ثم حدد مستخدما أو مجموعة أو كيان خدمة أو جميع مستخدمي مساحة العمل.
3. حدد إذنا من القائمة المنسدلة للإذن.
4. انقر فوق إضافة ثم انقر فوق حفظ.

الحفاظ على حالة تطبيق Databricks

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

تسجيل الدخول من تطبيق Databricks

إشعار

لعرض السجلات في واجهة مستخدم تطبيقات Databricks أو باستخدام عنوان URL للتطبيق، يجب أن يقوم التطبيق بتسجيل الدخول إلى stdout و stderr.

لعرض الإخراج القياسي والخطأ القياسي لأحد التطبيقات، في صفحة التفاصيل للتطبيق، انقر فوق علامة التبويب سجلات . راجع عرض تفاصيل تطبيق Databricks.

يمكنك أيضا عرض الإخراج القياسي وسجلات الأخطاء القياسية في <appurl>/logz الارتباط. على سبيل المثال، إذا كان عنوان URL لتطبيقك هو https://my-app-1234567890.my-instance.databricksapps.com، فيمكنك عرض السجلات في https://my-app-1234567890.my-instance.databricksapps.com/logz. للعثور على عنوان URL للتطبيق، انتقل إلى صفحة تفاصيل التطبيق.

تحديد تبعيات المكتبة لتطبيق Databricks

إذا كان تطبيقك يتطلب مكتبات Python بخلاف الحزم المثبتة تلقائيا مع التوزيع، فاستخدم ملفا requirements.txt لتعريف تلك المكتبات. إذا تكررت حزمة في requirements.txt الملف إحدى الحزم المثبتة تلقائيا، فإن الإصدار الموجود في الحزمة requirements.txt المثبتة تلقائيا يتجاوز الحزمة المثبتة تلقائيا.

للحصول على قائمة الحزم والإصدارات المثبتة كجزء من نشر التطبيق، راجع مكتبات Python المثبتة.

ما هي رؤوس HTTP التي يتم تمريرها إلى تطبيقات Databricks؟

يتم تمرير العناوين التالية X-Forwarded-* من الوكيل العكسي لتطبيقات Databricks إلى التطبيقات:

الرأس	‏‏الوصف
X-Forwarded-Host	المضيف الأصلي أو المجال المطلوب من قبل العميل.
X-Forwarded-Preferred-Username	اسم المستخدم الذي يوفره IdP.
X-Forwarded-User	معرف المستخدم الذي يوفره IdP.
X-Forwarded-Email	البريد الإلكتروني للمستخدم الذي يوفره IdP.
X-Real-Ip	عنوان IP للعميل الذي قدم الطلب الأصلي.
X-Request-Id	UUID للطلب.

ما هي أطر العمل التي تدعمها Databricks Apps؟

يمكنك استخدام معظم أطر عمل Python لتطوير تطبيقاتك. للاطلاع على أمثلة لاستخدام أطر عمل معينة، بما في ذلك Dash وGradio وStreamlit، حدد من مكتبة تطبيقات القوالب عند إنشاء تطبيق جديد في واجهة المستخدم. راجع كيف أعمل إنشاء تطبيق في واجهة مستخدم تطبيقات Databricks؟.

بالنسبة إلى المتغيرات الخاصة ب Streamlit التي تم تعيينها في بيئة وقت تشغيل تطبيقات Databricks، راجع متغيرات البيئة الافتراضية ل Streamlit.

أفضل الممارسات: استخدام الأسرار لتخزين المعلومات الحساسة لتطبيق Databricks

توصي Databricks باستخدام الأسرار لتخزين المعلومات الحساسة، مثل بيانات اعتماد المصادقة. لمعرفة المزيد حول استخدام الأسرار، راجع إدارة الأسرار.

لاستخدام سر مع تطبيقك:

1. تكوين البيانات السرية كمورد تطبيق.

   

2. أضف إدخالا للبيانات السرية في ملف تكوين التطبيق app.yaml .

   env:
     - name: "API_TOKEN"
       valueFrom: "api-token-value"
   

3. للإشارة إلى السر في التعليمات البرمجية للتطبيق، استخدم قيمة name الحقل (API_TOKEN في هذا المثال) للإشارة إلى قيمة المفتاح المكونة.

token = os.getenv('API_TOKEN')

أفضل الممارسات: استخدام ميزات Azure Databricks لمعالجة البيانات

تم تصميم حساب Databricks Apps لخدمة واجهة المستخدم. لضمان أن تطبيقاتك يمكنها دعم العديد من المستخدمين بكفاءة، يجب عليك استخدام ميزات Databricks لتنفيذ أي شيء آخر غير معالجة البيانات البسيطة. على سبيل المثال، استخدم Databricks SQL لمعالجة مجموعات البيانات وتخزينها، أو مهام Databricks لمعالجة البيانات، أو النموذج الذي يخدم الاستعلام عن نماذج الذكاء الاصطناعي.

أفضل الممارسات: اتبع أفضل ممارسات الترميز الآمنة

توصي Databricks باتباع ممارسات الترميز الآمنة عند تطوير تطبيقاتك، بما في ذلك تحديد معلمات الاستعلامات لتجنب هجمات حقن SQL. راجع واجهة برمجة تطبيقات تنفيذ العبارة.

إرشادات مهمة لتنفيذ تطبيقات Databricks

• ترسل SIGKILL تطبيقات Databricks إشارة بعد SIGTERM15 ثانية من ، لذلك يجب إيقاف تشغيل التطبيقات بأمان ما لا يزيد عن 15 ثانية بعد تلقي SIGTERM الإشارة. إذا لم يتم إنهاء أحد التطبيقات بعد 15 ثانية، SIGKILL يتم إرسال إشارة لإنهاء العملية وجميع العمليات التابعة.
• نظرا لأنه يتم تشغيل تطبيقات Databricks كمستخدم نظام غير متميز، لا يمكنهم تنفيذ العمليات التي تتطلب التشغيل في سياق أمان متميز، مثل العمليات التي تتطلب أذونات المستخدم الجذر.
• تتم إعادة توجيه الطلبات من وكيل عكسي، لذلك يجب ألا تعتمد التطبيقات على أصول الطلبات. تعين بيئة Databricks Apps معلمات التكوين المطلوبة لأطر العمل المدعومة.
• نظرا لأن إطار عمل تطبيق Databricks يدير اتصالات أمان طبقة النقل (TLS)، يجب ألا تقوم تطبيقاتك بأي اتصال TLS أو عمليات تأكيد الاتصال.
• يجب تنفيذ تطبيقاتك لمعالجة الطلبات بتنسيق نص واضح HTTP/2 (H2C).
• يجب أن تستضيف تطبيقات Databricks خوادم HTTP على 0.0.0.0 واستخدام رقم المنفذ المحدد في DATABRICKS_APP_PORT متغير البيئة. راجع متغيرات البيئة.