مشاركة عبر

التحكم في إصدار Git لدفاتر الملاحظات (قديم)

  • مقالة

هام

تمت إزالة دعم تكامل Git لدفتر الملاحظات القديم في 31 يناير 2024. توصي Databricks باستخدام مجلدات Databricks Git لمزامنة عملك في Databricks مع مستودع Git بعيد.

توضح هذه المقالة كيفية إعداد عنصر تحكم إصدار Git لدفاتر الملاحظات (الميزة القديمة). يمكنك أيضا استخدام Databricks CLI أو واجهة برمجة تطبيقات مساحة العمل لاستيراد دفاتر الملاحظات وتصديرها وتنفيذ عمليات Git في بيئة التطوير المحلية.

تمكين تعيين إصدار Git وتعطيله

يتم تمكين التحكم بالإصدار بشكل افتراضي. لتبديل هذا الإعداد:

  1. انتقل إلى إعدادات الإعدادات> Workspace.
  2. في قسم Advanced ، قم بإلغاء تحديد تبديل Notebook Git Versioning .

تكوين التحكم بالإصدار

لتكوين التحكم في الإصدار، قم بإنشاء بيانات اعتماد الوصول في موفر Git الخاص بك، ثم أضف بيانات الاعتماد هذه إلى Azure Databricks.

استخدام إصدارات دفتر الملاحظات

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

سجل الإصدارات

إشعار

لا يمكنك تعديل دفتر ملاحظات أثناء فتح لوحة المحفوظات.

  1. انقر في أيقونة محفوظات الإصدار الشريط الجانبي الأيمن. يعرض شريط حالة Git Git: غير مرتبط.

    شريط حالة Git

  2. انقر فوق Git: غير مرتبط.

    يظهر مربع الحوار تفضيلات Git. في المرة الأولى التي تفتح فيها دفتر الملاحظات، تكون الحالة إلغاء ارتباط، لأن دفتر الملاحظات ليس في GitHub.

    تفضيلات Git - ربط دفتر ملاحظات جديد

  3. في حقل الحالة، انقر فوق ارتباط.

  4. في حقل Link، الصق عنوان URL لمستودع GitHub.

  5. انقر فوق القائمة المنسدلة Branch وحدد فرعا أو اكتب اسم فرع جديد.

  6. في الحقل Path in Git folder، حدد مكان تخزين الملف في المستودع.

    تحتوي دفاتر ملاحظات Python على ملحق .pyالملف الافتراضي المقترح . إذا كنت تستخدم .ipynb، فسيتم حفظ دفتر الملاحظات بتنسيق دفتر ملاحظات iPython. إذا كان الملف موجودا بالفعل على GitHub، يمكنك نسخ عنوان URL للملف ولصقه مباشرة.

  7. انقر فوق حفظ لإنهاء ربط دفتر الملاحظات. إذا لم يكن هذا الملف موجودا مسبقا، يتم عرض مطالبة مع الخيار حفظ هذا الملف إلى مستودع GitHub الخاص بك.

  8. اكتب رسالة وانقر فوق حفظ.

حفظ دفتر ملاحظات إلى GitHub

بينما يتم حفظ التغييرات التي تجريها على دفتر الملاحظات تلقائيا في محفوظات إصدار Azure Databricks، لا تستمر التغييرات تلقائيا في GitHub.

  1. انقر في أيقونة محفوظات الإصدار الشريط الجانبي الأيسر لفتح لوحة المحفوظات.

    لوحة المحفوظات - احفظ الآن

  2. انقر فوق حفظ الآن لحفظ دفتر ملاحظاتك في GitHub. يظهر مربع الحوار حفظ إصدار دفتر الملاحظات.

  3. بشكل اختياري، أدخل رسالة لوصف التغيير الذي قمت به.

  4. تأكد من تحديد الالتزام أيضا ب Git .

    حفظ الإصدار

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

إرجاع دفتر ملاحظات أو تحديثه إلى إصدار من GitHub

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

  1. انقر في أيقونة محفوظات الإصدار الشريط الجانبي الأيسر لفتح لوحة المحفوظات.

    لوحة المحفوظات

  2. اختر إدخالا في لوحة المحفوظات. يعرض Azure Databricks هذا الإصدار.

  3. انقر فوق استعادة هذا الإصدار.

  4. انقر فوق تأكيد لتأكيد رغبتك في استعادة هذا الإصدار.

  1. انقر في أيقونة محفوظات الإصدار الشريط الجانبي الأيسر لفتح لوحة المحفوظات.

  2. يعرض شريط حالة Git Git: Synced.

    لوحة المحفوظات - صورة حفظ الآن

  3. انقر فوق Git: Synced.

    تفضيلات Git - إلغاء ارتباط دفتر الملاحظات

  4. في مربع الحوار تفضيلات Git، انقر فوق إلغاء الارتباط.

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

  6. انقر فوق تأكيد لتأكيد رغبتك في إلغاء ارتباط دفتر الملاحظات بعنصر تحكم الإصدار.

استخدام الفروع

يمكنك العمل على أي فرع من مستودعك وإنشاء فروع جديدة داخل Azure Databricks.

إنشاء فرع

  1. انقر في أيقونة محفوظات الإصدار الشريط الجانبي الأيسر لفتح لوحة المحفوظات.

  2. انقر فوق شريط حالة Git لفتح لوحة GitHub.

  3. انقر فوق القائمة المنسدلة Branch.

  4. أدخل اسم فرع.

    إنشاء فرع

  5. حدد الخيار Create Branch في أسفل القائمة المنسدلة. تتم الإشارة إلى الفرع الأصل. أنت دائما تفرع من الفرع المحدد الحالي.

إنشاء طلب سحب

  1. انقر في أيقونة محفوظات الإصدار الشريط الجانبي الأيسر لفتح لوحة المحفوظات.

  2. انقر فوق شريط حالة Git لفتح لوحة GitHub.

    تفضيلات Git - إنشاء طلب سحب

  3. انقر فوق Create PR. يفتح GitHub على صفحة طلب سحب للفرع.

إعادة إنشاء فرع

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

Rebase

على سبيل المثال، افترض أنك تعمل على databricks/reference-apps. يمكنك نسخه في حسابك الخاص (على سبيل المثال، brkyvz) وبدء العمل على فرع يسمى my-branch. إذا تم دفع تحديث جديد إلى databricks:master، فسيعرض Rebase الزر، وستتمكن من سحب التغييرات إلى الفرع brkyvz:my-branchالخاص بك .

يعمل Rebasing بشكل مختلف قليلا في Azure Databricks. افترض بنية الفرع التالية:

قبل إعادة بنية الفرع

بعد إعادة قاعدة، تبدو بنية الفرع كما يلي:

بعد إعادة بنية الفرع

ما هو مختلف هنا هو أن Commits C5 وC6 لا تنطبق على أعلى C4. تظهر كتغيرات محلية في دفتر الملاحظات. تظهر تعارضات الدمج كما يلي:

تعارض الدمج

يمكنك بعد ذلك الالتزام ب GitHub مرة أخرى باستخدام الزر Save Now .

ماذا يحدث إذا تفرع شخص ما من فرعي الذي قمت بإعادة بناءه للتو؟

إذا كان فرعك (على سبيل المثال، branch-a) هو الأساس لفرع آخر (branch-b)، وقمت بإعادة الأساس، فلا داعي للقلق! بمجرد أن يعيد المستخدم أيضا قاعدة branch-b، سيعمل كل شيء. أفضل ممارسة في هذه الحالة هي استخدام فروع منفصلة لدفاتر ملاحظات منفصلة.

أفضل الممارسات لمراجعات التعليمات البرمجية

يدعم Azure Databricks تفريع Git.

  • يمكنك ربط دفتر ملاحظات بأي فرع في مستودع. توصي Azure Databricks باستخدام فرع منفصل لكل دفتر ملاحظات.
  • أثناء التطوير، يمكنك ربط دفتر ملاحظات بتشعب مستودع أو بفرع غير افتراضي في المستودع الرئيسي. لدمج التغييرات في المصدر، يمكنك استخدام رابط Create PR في مربع الحوار Git Preferences في Azure Databricks لإنشاء طلب سحب GitHub. يظهر الارتباط Create PR فقط إذا كنت لا تعمل على الفرع الافتراضي للمستودع الأصل.

استكشاف الأخطاء وإصلاحها

إذا تلقيت أخطاء تتعلق بمزامنة محفوظات GitHub، فتحقق مما يلي:

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

الترحيل إلى مجلدات Databricks Git

يمكن للمستخدمين الذين يحتاجون إلى الترحيل إلى مجلدات Databricks Git من عنصر تحكم إصدار Git القديم استخدام الدليل التالي: