التحكم في المصدر في Synapse Studio

  • مقالة
  • قراءة خلال 11 دقائق

بشكل افتراضي، يقوم Synapse Studio بتأليف الكتاب مباشرة مقابل خدمة Synapse. إذا كنت بحاجة إلى التعاون باستخدام Git للتحكم بالمصدر، فإن Synapse Studio يسمح لك بإقران مساحة عملك بمستودع Git أو Azure DevOps أو GitHub.

ستوضح هذه المقالة كيفية تكوين مساحة عمل Synapse والعمل فيها مع تمكين مستودع git. ونسلط الضوء أيضا على بعض أفضل الممارسات ودليل استكشاف الأخطاء وإصلاحها.

ملاحظة

لاستخدام GitHub في Azure Gov وAzure China، يمكنك إحضار تطبيق OAuth الخاص بك GitHub في Synapse Studio لتكامل git. تجربة التكوين هي نفسها مع ADF. يمكنك الرجوع إلى مدونة الإعلان.

المتطلبات الأساسية

يجب أن يكون لدى المستخدمين دور Azure Contributor (Azure RBAC) أو دور أعلى في مساحة عمل Synapse لتكوين مستودع Git وتحريره وقطع اتصال مستودع Git باستخدام Synapse.

تكوين مستودع Git في Synapse Studio

بعد تشغيل Synapse Studio ، يمكنك تكوين مستودع git في مساحة العمل الخاصة بك. يمكن إقران مساحة عمل Synapse Studio بمستودع git واحد فقط في كل مرة.

طريقة التكوين 1: الشريط العمومي

في الشريط العمومي Synapse Studio، حدد القائمة المنسدلة Synapse Live ، ثم حدد إعداد مستودع التعليمات البرمجية.

Configure the code repository settings from authoring

طريقة التكوين 2: إدارة الموزع

انتقل إلى مركز إدارة Synapse Studio. حدد ⁧⁩Git configuration⁧⁩ في قسم ⁧⁩Source control.⁧⁩ إذا لم يكن لديك أي مستودع متصل، فانقر فوق تهيئة.

Configure the code repository settings from management hub

يمكنك توصيل Azure DevOps أو مستودع git GitHub في مساحة العمل الخاصة بك.

الاتصال مع Azure DevOps Git

يمكنك إقران مساحة عمل Synapse بمستودع Azure DevOps للتحكم في المصدر والتعاون وتعيين الإصدار وما إلى ذلك. إذا لم يكن لديك مستودع Azure DevOps، فاتبع هذه الإرشادات لإنشاء موارد المستودع.

Azure DevOps Git repository settings

عند الاتصال بمستودع git، حدد أولا نوع المستودع ك Azure DevOps git، ثم حدد مستأجرا واحدا Azure AD من القائمة المنسدلة، وانقر فوق متابعة.

Configure the code repository settings

يعرض جزء التكوين إعدادات git الخاصة ب Azure DevOps التالية:

الإعداد الوصف القيمة
نوع المستودع نوع مستودع أكواد Azure Repos.
 Azure DevOps Git أو GitHub
تسجيل الدخول عبر المستأجر خانة الاختيار لتسجيل الدخول باستخدام حساب المستأجر المتقاطع. غير محدد (افتراضي)
Azure Active Directory اسم مستأجر Azure AD. <your tenant name>
حساب Azure DevOps اسم مؤسستك في Azure Repos. يمكنك تحديد موقع اسم مؤسستك في Azure Repos على https://{organization name}.visualstudio.com. يمكنك تسجيل الدخول إلى مؤسسة Azure Repos للوصول إلى ملف تعريف Visual Studio الخاص بك والاطلاع على مستودعاتك ومشاريعك. <your organization name>
اسم المشروع اسم مشروعك في Azure Repos. يمكنك تحديد موقع اسم مشروع Azure Repos الخاص بك على https://{organization name}.visualstudio.com/{project name}. <your Azure Repos project name>
اسم المستودع اسم مستودع أكواد Azure Repos الخاص بك. تحتوي مشاريع Azure Repos على مستودعات Git لإدارة التعليمات البرمجية المصدر مع نمو مشروعك. يمكنك إنشاء مستودع جديد أو استخدام مستودع موجود بالفعل في مشروعك. <your Azure Repos code repository name>
فرع التعاون فرع التعاون في Azure Repos الذي يتم استخدامه للنشر. بشكل افتراضي ، لها master. قم بتغيير هذا الإعداد إذا كنت تريد نشر موارد من فرع آخر. يمكنك تحديد فروع حالية أو إنشاء فروع جديدة <your collaboration branch name>
المجلد الجذر المجلد الجذر الخاص بك في فرع التعاون في Azure Repos. <your root folder name>
استيراد الموارد الموجودة إلى المستودع يحدد ما إذا كان سيتم استيراد الموارد الموجودة من Synapse Studio إلى مستودع Azure Repos Git أم لا. حدد المربع لاستيراد موارد مساحة العمل (باستثناء التجمعات) إلى مستودع Git المقترن بتنسيق JSON. يقوم هذا الإجراء بتصدير كل مورد على حدة. عند عدم تحديد هذا المربع، لا يتم استيراد الموارد الموجودة. محدد (افتراضي)
استيراد الموارد إلى هذا الفرع حدد الفرع الذي يتم استيراد الموارد إليه (البرنامج النصي sql ودفتر الملاحظات وتعريف مهمة الشرارة ومجموعة البيانات وتدفق البيانات وما إلى ذلك).

يمكنك أيضا استخدام رابط المستودع للإشارة بسرعة إلى مستودع git الذي تريد الاتصال به.

استخدم مستأجر Azure Active Directory مختلف

يمكن أن يكون Azure Repos Git repo في مستأجر Azure Active Directory مختلف. لتحديد مستأجر Azure AD مختلف، يجب أن يكون لديك أذونات المسؤول لاشتراك Azure الذي تستخدمه. لمزيد من المعلومات، راجع تغيير مسؤول الاشتراك

هام

للاتصال بـAzure Active Directory آخر، يجب أن يكون المستخدم الذي قام بتسجيل الدخول جزءًا من هذا الدليل النشط.

استخدم حساب Microsoft الشخصي الخاص بك

لاستخدام حساب Microsoft شخصي لتكامل Git، يمكنك ربط Azure Repo الشخصي الخاص بك بالدليل النشط لمؤسستك.

  1. أضف حساب Microsoft الشخصي الخاص بك إلى Active Directory الخاص بمؤسستك كضيف. لمزيد من المعلومات، راجع إضافة مستخدمي تعاون Azure Active Directory B2B في مدخل Azure .

  2. سجّل الدخول إلى مدخل Azure باستخدام حساب Microsoft الشخصي الخاص بك. ثم قم بالتبديل إلى Active Directory الخاص بمؤسستك.

  3. انتقل إلى قسم Azure DevOps، حيث ترى الآن الريبو الشخصي الخاص بك. حدد الريبو وتواصل مع Active Directory.

بعد خطوات التكوين هذه، يتوفر الريبو الشخصي عند إعداد تكامل Git في Synapse Studio.

لمزيد من المعلومات حول توصيل Azure Repos ب Active Directory الخاص بمؤسستك، راجع الاتصال مؤسستك إلى Azure Active Directory.

استخدام حساب Azure DevOps عبر المستأجر

عندما لا يكون Azure DevOps في نفس المستأجر مثل مساحة عمل Synapse، يمكنك تكوين مساحة العمل باستخدام حساب Azure DevOps عبر المستأجر باستخدام الدليل أدناه.

  1. حدد خيار تسجيل الدخول عبر المستأجر وانقر على متابعة

    Select the cross tenant sign in

  2. حدد موافق في مربع الحوار.

    Confirm the cross tenant sign in

  3. انقر فوق استخدام حساب آخر وقم بتسجيل الدخول باستخدام حساب Azure DevOps الخاص بك.

    Use another account

  4. بعد تسجيل الدخول، اختر الدليل والمستودع وقم بتكوينهما وفقا لذلك.

    Choose the directory

    ملاحظة

    لتسجيل الدخول إلى مساحة العمل، تحتاج إلى استخدام تسجيل الدخول الأول لتسجيل الدخول إلى حساب مستخدم مساحة عمل Synapse. يتم استخدام حساب Azure DevOps الخاص بالمستأجر المتقاطع فقط لتسجيل الدخول والحصول على حق الوصول إلى ريبو Azure DevOps المقترن بمساحة عمل Synapse هذه.

الاتصال مع GitHub

يمكنك إقران مساحة عمل بمستودع GitHub للتحكم في المصدر والتعاون وتعيين الإصدارات. إذا لم يكن لديك حساب أو مستودع GitHub، فاتبع هذه الإرشادات لإنشاء مواردك.

يدعم تكامل GitHub مع Synapse Studio كلا من GitHub العامة (أي https://github.com) و GitHub Enterprise. يمكنك استخدام كل من مستودعات GitHub العامة والخاصة طالما لديك إذن قراءة وكتابة للمستودع في GitHub.

إعدادات GitHub

عند الاتصال بمستودع git، حدد أولا نوع المستودع الخاص بك على أنه GitHub، ثم قم بتوفير حساب GitHub الخاص بك أو عنوان URL GitHub Enterprise Server إذا كنت تستخدم GitHub Enterprise Server أو اسم مؤسسة GitHub Enterprise إذا كنت تستخدم GitHub Enterprise Cloud. حدد ⁦⁩Continue⁦⁩.

ملاحظة

إذا كنت تستخدم GitHub Enterprise Cloud، فاترك خانة الاختيار استخدام خادم المؤسسة GitHub في وضع علامة الواحدة.

GitHub repository settings

يُظهر جزء التكوين إعدادات مستودع GitHub التالية:

الإعداد الوصف القيمة
نوع المستودع نوع مستودع أكواد Azure Repos. GitHub
استخدم GitHub Enterprise خانة اختيار لتحديد GitHub Enterprise غير محدد (افتراضي)
عنوان URL لـGitHub Enterprise عنوان URL الجذر لـGitHub Enterprise (يجب أن يكون HTTPS لخادم GitHub Enterprise المحلي). على سبيل المثال: https://github.mydomain.com. مطلوب فقط إذا تم تحديد استخدام GitHub Enterprise <your GitHub enterprise url>
حساب GitHub اسم حساب GitHub الخاص بك. يمكن العثور على هذا الاسم من https://github.com/{account name}/{اسم المستودع}. يطالبك التنقل إلى هذه الصفحة بإدخال بيانات اعتماد GitHub OAuth في حساب GitHub الخاص بك. <your GitHub account name>
اسم المستودع اسم مستودع كود GitHub الخاص بك. تحتوي حسابات GitHub على مستودعات Git لإدارة كود المصدر الخاص بك. يمكنك إنشاء مستودع جديد أو استخدام مستودع موجود بالفعل في حسابك. <your repository name>
فرع التعاون فرع التعاون GitHub الخاص بك والذي يتم استخدامه للنشر. بشكل افتراضي ، سيدها. قم بتغيير هذا الإعداد إذا كنت تريد نشر موارد من فرع آخر. <your collaboration branch>
المجلد الجذر المجلد الجذر الخاص بك في فرع التعاون GitHub الخاص بك. <your root folder name>
استيراد الموارد الموجودة إلى المستودع يحدد ما إذا كان سيتم استيراد الموارد الموجودة من Synapse Studio إلى مستودع Git. حدد المربع لاستيراد موارد مساحة العمل (باستثناء التجمعات) إلى مستودع Git المقترن بتنسيق JSON. يقوم هذا الإجراء بتصدير كل مورد على حدة. عند عدم تحديد هذا المربع، لا يتم استيراد الموارد الموجودة. محدد (افتراضي)
استيراد الموارد إلى هذا الفرع حدد الفرع الذي يتم استيراد الموارد (البرنامج النصي SQL ودفتر الملاحظات وتعريف مهمة الشرارة ومجموعة البيانات وتدفق البيانات وما إلى ذلك).

منظمات GitHub

يتطلب الاتصال بمؤسسة GitHub من المؤسسة منح إذن ل Synapse Studio. يجب على المستخدم الذي لديه أذونات ADMIN على المؤسسة تنفيذ الخطوات التالية.

الاتصال GitHub لأول مرة

إذا كنت تتصل GitHub من Synapse Studio لأول مرة، فاتبع هذه الخطوات للاتصال بمؤسسة GitHub.

  1. في جزء تكوين Git، أدخل اسم المؤسسة في حقل حساب GitHub. ستظهر مطالبة لتسجيل الدخول إلى GitHub.

  2. تسجيل الدخول باستخدام بيانات اعتماد المستخدم الخاصة بك.

  3. سيطلب منك تفويض Synapse كتطبيق يسمى Azure Synapse. في هذه الشاشة، سترى خيارا لمنح الإذن ل Synapse للوصول إلى المؤسسة. إذا كنت لا ترى خيار منح الإذن، فاطلب من المسؤول منح الإذن يدويًا من خلال GitHub.

بمجرد اتباع هذه الخطوات، ستتمكن مساحة العمل الخاصة بك من الاتصال بكل من المستودعات العامة والخاصة داخل مؤسستك. إذا لم تتمكن من الاتصال، فحاول مسح ذاكرة التخزين المؤقت للمتصفح وأعد المحاولة.

متصل بالفعل بـGitHub باستخدام حساب شخصي

إذا كنت قد اتصلت بالفعل بـ GitHub ومنحت إذنًا فقط للوصول إلى حساب شخصي، فاتبع الخطوات التالية لمنح أذونات لمؤسسة.

  1. انتقل إلى GitHub وافتح الإعدادات.

    Open GitHub settings

  2. حدد تطبيقات. في علامة التبويب تطبيقات OAuth المعتمدة ، من المفترض أن تشاهد Azure Synapse.

    Authorize OAuth Apps

  3. حدد Azure Synapse وامنح حق الوصول إلى مؤسستك.

    Grant organization permission

بمجرد إكمال هذه الخطوات، ستتمكن مساحة العمل الخاصة بك من الاتصال بكل من المستودعات العامة والخاصة داخل مؤسستك.

التحكم بالإصدار

تسمح أنظمة التحكم في الإصدار (المعروفة أيضا باسم التحكم في المصدر) للمطورين بالتعاون في التعليمات البرمجية وتتبع التغييرات. يعد التحكم في المصدر أداة أساسية للمشاريع متعددة المطورين.

إنشاء فروع ميزات

يحتوي كل مستودع Git مرتبط ب Synapse Studio على فرع تعاون. (أوmainmaster هو فرع التعاون الافتراضي). يمكن للمستخدمين أيضًا إنشاء فروع ميزات من خلال النقر فوق ⁧⁩+ New Branch⁧⁩ في القائمة المنسدلة للفرع.

Create new branch

بمجرد ظهور جزء الفرع الجديد، أدخل اسم فرع الميزة الخاص بك وحدد فرعًا لتأسيس العمل عليه.

Create branch based on private branch

عندما تكون مستعدًا لدمج التغييرات من فرع الميزات إلى فرع التعاون، انقر على القائمة المنسدلة للفرع وحدد ⁧⁩Create pull request⁧⁩. ينقلك هذا الإجراء إلى موفر Git حيث يمكنك رفع طلبات السحب وإجراء مراجعات التعليمات البرمجية ودمج التغييرات في فرع التعاون. يسمح لك فقط بالنشر إلى خدمة Synapse من فرع التعاون الخاص بك.

Create a new pull request

تكوين إعدادات النشر

بشكل افتراضي، يقوم Synapse Studio بإنشاء قوالب مساحة العمل وحفظها في فرع يسمى workspace_publish. لتكوين فرع نشر مخصص، أضف ملف ⁧publish_config.json⁩ إلى المجلد الجذر في فرع التعاون. عند النشر، يقرأ Synapse Studio هذا الملف، ويبحث عن الحقل publishBranch، ويحفظ ملفات قالب مساحة العمل في الموقع المحدد. إذا لم يكن الفرع موجودا، فسيقوم Synapse Studio بإنشائه تلقائيا. وسيبدو هذا الملف على النحو التالي:

{
    "publishBranch": "workspace_publish"
}

يمكن أن يحتوي Synapse Studio على فرع نشر واحد فقط في كل مرة. عند تحديد فرع نشر جديد، لن يتم حذف فرع النشر السابق. إذا كنت تريد إزالة فرع النشر السابق، فقم بحذفه يدويًا.

نشر تغييرات التعليمات البرمجية

بعد دمج التغييرات في فرع التعاون، انقر فوق نشر لنشر تغييرات التعليمات البرمجية يدويا في فرع التعاون إلى خدمة Synapse.

Publish changes

سيتم فتح جزء جانبي حيث ستؤكد صحة فرع النشر والتغييرات المعلقة. بمجرد التحقق من التغييرات، انقر فوق ⁧⁩OK⁧⁩ لتأكيد النشر.

Confirm the correct publish branch

هام

لا يمثل فرع التعاون ما يتم نشره في الخدمة. يجب نشر التغييرات في فرع التعاون يدويا.

التبديل إلى مستودع Git مختلف

للتبديل إلى مستودع Git مختلف، انتقل إلى صفحة «Git configuration» في مركز الإدارة أسفل ⁧⁩Source control⁧⁩. حدد ⁧⁩Disconnect⁧⁩.

Git icon

أدخل اسم مساحة العمل وانقر فوق قطع الاتصال لإزالة مستودع Git المقترن بمساحة العمل.

بعد إزالة الاقتران مع الريبو الحالي، يمكنك تكوين إعدادات Git لاستخدام ريبو مختلف ثم استيراد الموارد الموجودة إلى الريبو الجديد.

هام

لا تؤدي إزالة تكوين Git من مساحة عمل إلى حذف أي شيء من المستودع. ستحتوي مساحة عمل Synapse على جميع الموارد المنشورة. يمكنك متابعة تحرير مساحة العمل مباشرة مقابل الخدمة.

أفضل الممارسات لتكامل Git

  • الأذونات. بعد أن يكون لديك مستودع git متصل بمساحة العمل الخاصة بك ، سيتمكن أي شخص يمكنه الوصول إلى repo git الخاص بك مع أي دور في مساحة العمل الخاصة بك من تحديث القطع الأثرية ، مثل البرنامج النصي sql والكمبيوتر المحمول وتعريف مهمة الشرارة ومجموعة البيانات وتدفق البيانات وخط الأنابيب في وضع git. عادة لا تريد أن يكون لكل عضو في الفريق أذونات لتحديث مساحة العمل. امنح إذن مستودع git فقط لمؤلفي القطع الأثرية في مساحة عمل Synapse.
  • التعاون. يوصى بعدم السماح بالإيداعات المباشرة إلى فرع التعاون. يمكن أن يساعد هذا التقييد في منع الأخطاء حيث أن كل تسجيل وصول سيخضع لعملية مراجعة طلب السحب الموضحة في إنشاء فروع الميزات .
  • Synapse الوضع المباشر. بعد النشر في وضع git ، ستنعكس جميع التغييرات في وضع Synapse المباشر. في وضع Synapse المباشر، يتم تعطيل النشر. ويمكنك عرض وتشغيل القطع الأثرية في الوضع المباشر إذا تم منحك الإذن الصحيح.
  • تحرير القطع الأثرية في الاستوديو. Synapse studio هو المكان الوحيد الذي يمكنك فيه تمكين التحكم في مصدر مساحة العمل ومزامنة التغييرات مع git تلقائيا. لن تتم مزامنة أي تغيير عبر SDK ، PowerShell ، مع git. نوصيك دائما بتحرير القطع الأثرية في Studio عند تمكين git.

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

الوصول إلى وضع git

إذا تم منحك الإذن إلى مستودع git GitHub المرتبط بمساحة العمل الخاصة بك ، ولكن لا يمكنك الوصول إلى وضع Git:

  1. امسح ذاكرة التخزين المؤقت وقم بتحديث الصفحة.

  2. قم بتسجيل الدخول إلى حساب GitHub الخاص بك.

فرع النشر التي لا معنى لها

إذا كان فرع النشر غير متزامن مع فرع التعاون ويحتوي على موارد قديمة على الرغم من النشر الأخير، فحاول اتباع الخطوات التالية:

  1. قم بإزالة مستودع Git الحالي الخاص بك

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

  3. قم بإنشاء طلب سحب لدمج التغييرات في فرع التعاون

ميزات غير معتمدة

  • لا يسمح Synapse Studio بانتقاء الالتزامات أو النشر الانتقائي للموارد.
  • لا يدعم Synapse Studio تخصيص رسالة الالتزام.
  • حسب التصميم ، سيتم الالتزام بإجراء الحذف في Studio ب git مباشرة

الخطوات التالية