التحكم في إصدار Git لدفاتر الملاحظات (قديم)
هام
تمت إزالة دعم تكامل Git لدفتر الملاحظات القديم في 31 يناير 2024. توصي Databricks باستخدام مجلدات Databricks Git لمزامنة عملك في Databricks مع مستودع Git بعيد.
توضح هذه المقالة كيفية إعداد عنصر تحكم إصدار Git لدفاتر الملاحظات (الميزة القديمة). يمكنك أيضا استخدام Databricks CLI أو واجهة برمجة تطبيقات مساحة العمل لاستيراد دفاتر الملاحظات وتصديرها وتنفيذ عمليات Git في بيئة التطوير المحلية.
تمكين تعيين إصدار Git وتعطيله
يتم تمكين التحكم بالإصدار بشكل افتراضي. لتبديل هذا الإعداد:
- انتقل إلى إعدادات الإعدادات> Workspace.
- في قسم Advanced ، قم بإلغاء تحديد تبديل Notebook Git Versioning .
تكوين التحكم بالإصدار
لتكوين التحكم في الإصدار، قم بإنشاء بيانات اعتماد الوصول في موفر Git الخاص بك، ثم أضف بيانات الاعتماد هذه إلى Azure Databricks.
استخدام إصدارات دفتر الملاحظات
يمكنك استخدام إصدارات دفتر الملاحظات في لوحة المحفوظات. افتح لوحة المحفوظات بالنقر فوق الشريط الجانبي الأيسر.
إشعار
لا يمكنك تعديل دفتر ملاحظات أثناء فتح لوحة المحفوظات.
ربط دفتر ملاحظات ب GitHub
انقر في الشريط الجانبي الأيمن. يعرض شريط حالة Git Git: غير مرتبط.
انقر فوق Git: غير مرتبط.
يظهر مربع الحوار تفضيلات Git. في المرة الأولى التي تفتح فيها دفتر الملاحظات، تكون الحالة إلغاء ارتباط، لأن دفتر الملاحظات ليس في GitHub.
في حقل الحالة، انقر فوق ارتباط.
في حقل Link، الصق عنوان URL لمستودع GitHub.
انقر فوق القائمة المنسدلة Branch وحدد فرعا أو اكتب اسم فرع جديد.
في الحقل Path in Git folder، حدد مكان تخزين الملف في المستودع.
تحتوي دفاتر ملاحظات Python على ملحق
.py
الملف الافتراضي المقترح . إذا كنت تستخدم.ipynb
، فسيتم حفظ دفتر الملاحظات بتنسيق دفتر ملاحظات iPython. إذا كان الملف موجودا بالفعل على GitHub، يمكنك نسخ عنوان URL للملف ولصقه مباشرة.انقر فوق حفظ لإنهاء ربط دفتر الملاحظات. إذا لم يكن هذا الملف موجودا مسبقا، يتم عرض مطالبة مع الخيار حفظ هذا الملف إلى مستودع GitHub الخاص بك.
اكتب رسالة وانقر فوق حفظ.
حفظ دفتر ملاحظات إلى GitHub
بينما يتم حفظ التغييرات التي تجريها على دفتر الملاحظات تلقائيا في محفوظات إصدار Azure Databricks، لا تستمر التغييرات تلقائيا في GitHub.
انقر في الشريط الجانبي الأيسر لفتح لوحة المحفوظات.
انقر فوق حفظ الآن لحفظ دفتر ملاحظاتك في GitHub. يظهر مربع الحوار حفظ إصدار دفتر الملاحظات.
بشكل اختياري، أدخل رسالة لوصف التغيير الذي قمت به.
تأكد من تحديد الالتزام أيضا ب Git .
انقر فوق حفظ.
إرجاع دفتر ملاحظات أو تحديثه إلى إصدار من GitHub
بمجرد ربط دفتر ملاحظات، يقوم Azure Databricks بمزامنة محفوظاتك مع Git في كل مرة تعيد فيها فتح لوحة المحفوظات. تحتوي الإصدارات التي تتم مزامنتها مع Git على تجزئات تثبيت كجزء من الإدخال.
انقر في الشريط الجانبي الأيسر لفتح لوحة المحفوظات.
اختر إدخالا في لوحة المحفوظات. يعرض Azure Databricks هذا الإصدار.
انقر فوق استعادة هذا الإصدار.
انقر فوق تأكيد لتأكيد رغبتك في استعادة هذا الإصدار.
إلغاء ارتباط دفتر ملاحظات
انقر في الشريط الجانبي الأيسر لفتح لوحة المحفوظات.
يعرض شريط حالة Git Git: Synced.
انقر فوق Git: Synced.
في مربع الحوار تفضيلات Git، انقر فوق إلغاء الارتباط.
انقر فوق حفظ.
انقر فوق تأكيد لتأكيد رغبتك في إلغاء ارتباط دفتر الملاحظات بعنصر تحكم الإصدار.
استخدام الفروع
يمكنك العمل على أي فرع من مستودعك وإنشاء فروع جديدة داخل Azure Databricks.
إنشاء فرع
انقر في الشريط الجانبي الأيسر لفتح لوحة المحفوظات.
انقر فوق شريط حالة Git لفتح لوحة GitHub.
انقر فوق القائمة المنسدلة Branch.
أدخل اسم فرع.
حدد الخيار Create Branch في أسفل القائمة المنسدلة. تتم الإشارة إلى الفرع الأصل. أنت دائما تفرع من الفرع المحدد الحالي.
إنشاء طلب سحب
انقر في الشريط الجانبي الأيسر لفتح لوحة المحفوظات.
انقر فوق شريط حالة Git لفتح لوحة GitHub.
انقر فوق Create PR. يفتح GitHub على صفحة طلب سحب للفرع.
إعادة إنشاء فرع
يمكنك أيضا إعادة إنشاء فرعك داخل Azure Databricks. يظهر ارتباط 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 القديم استخدام الدليل التالي: