مشاركة عبر

برنامج تشغيل Databricks ل SQLTools ل Visual Studio Code

  • مقالة

هام

هذه الميزة في المعاينة العامة.

يمكنك برنامج تشغيل Databricks ل SQLTools من استخدام ملحق SQLTools ل Visual Studio Code لاستعراض كائنات SQL وتشغيل استعلامات SQL في مساحات عمل Azure Databricks البعيدة.

قبل البدء

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

متطلبات مساحة العمل

يجب أن يكون لديك مساحة عمل Azure Databricks واحدة على الأقل متوفرة، ويجب أن تفي مساحة العمل بالمتطلبات التالية:

  • يجب أن تحتوي مساحة العمل على مستودع Databricks SQL واحد على الأقل.

    إشعار

    مجموعات Azure Databricks غير مدعومة من قبل برنامج تشغيل Databricks ل SQLTools.

  • بالنسبة لمساحات العمل التي تم تمكينها ل "كتالوج Unity"، يجب أن تحتوي مساحة العمل على كتالوج واحد على الأقل، مع مخطط واحد على الأقل (يسمى رسميا قاعدة بيانات) داخل هذا الكتالوج.

  • بالنسبة لمساحات العمل التي لم يتم تمكينها ل "كتالوج Unity"، يجب أن تحتوي مساحة العمل على مخطط واحد على الأقل (كان يسمى سابقا قاعدة بيانات).

متطلبات جهاز التطوير المحلي

يجب أن يكون لديك ما يلي على جهاز التطوير المحلي الخاص بك:

لتثبيت ملحق SQLTools، انتقل إلى SQLTools ثم انقر فوق تثبيت، أو:

  1. في Visual Studio Code، انقر فوق View > Extensions في القائمة الرئيسية.

  2. في مربع Search Extensions in Marketplace ، أدخل SQLTools.

  3. انقر فوق إدخال SQLTools من Matheus Teixeira.

    إشعار

    قد يكون هناك العديد من إدخالات SQLTools المدرجة. تأكد من النقر فوق الإدخال من Matheus Teixeira.

  4. انقر فوق تثبيت.

لتثبيت ملحق برنامج تشغيل Databricks ل SQLTools، انتقل إلى برنامج تشغيل Databricks ل SQLTools ثم انقر فوق تثبيت، أو:

  1. في Visual Studio Code، انقر فوق View > Extensions في القائمة الرئيسية.
  2. في مربع Search Extensions in Marketplace ، أدخل Databricks Driver for SQLTools.
  3. انقر فوق إدخال Databricks Driver for SQLTools.
  4. انقر فوق تثبيت.

المصادقة

يجب إعداد المصادقة لبرنامج تشغيل Databricks ل SQLTools كما يلي.

يدعم برنامج تشغيل Databricks ل SQLTools أنواع مصادقة Azure Databricks التالية:

إشعار

لا يدعم برنامج تشغيل Databricks ل SQLTools الرموز المميزة لمعرف Microsoft Entra.

مصادقة الرمز المميز للوصول الشخصي ل Azure Databricks

لاستخدام برنامج تشغيل Databricks ل SQLTools مع مصادقة رمز الوصول الشخصي Azure Databricks، يجب أن يكون لديك رمز وصول شخصي Azure Databricks. لإنشاء رمز مميز للوصول الشخصي، قم بما يلي:

  1. في مساحة عمل Azure Databricks، انقر فوق اسم مستخدم Azure Databricks في الشريط العلوي، ثم حدد الإعدادات من القائمة المنسدلة.
  2. انقر فوق المطور.
  3. إلى جانب رموز الوصول المميزة، انقر فوق إدارة.
  4. النقر على Generate new token.
  5. (اختياري) أدخل تعليقا يساعدك على تحديد هذا الرمز المميز في المستقبل، وتغيير العمر الافتراضي للرمز المميز وهو 90 يوما. لإنشاء رمز مميز بدون مدة بقاء (غير مستحسن)، اترك مربع مدة البقاء (أيام) فارغا (فارغ).
  6. انقر فوق "Generate".
  7. انسخ الرمز المميز المعروض إلى موقع آمن، ثم انقر فوق تم.

إشعار

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

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

مصادقة Azure Databricks OAuth من جهاز إلى جهاز (M2M)

يمكنك استخدام مصادقة Azure Databricks OAuth من جهاز إلى جهاز (M2M) للمصادقة مع برنامج تشغيل Databricks ل SQLTools، كما يلي:

إشعار

تتوفر مصادقة Azure Databricks OAuth M2M في برنامج تشغيل Databricks لإصدارات SQLTools 0.4.2 والإصدارات الأحدث.

  1. أكمل خطوات التكوين لمصادقة OAuth M2M. راجع مصادقة OAuth من جهاز إلى جهاز (M2M).
  2. إنشاء ملف تعريف تكوين Azure Databricks باستخدام إعدادات تكوين مصادقة OAuth M2M. راجع قسم "التكوين" في مصادقة OAuth من جهاز إلى جهاز (M2M).
  3. تثبيت وفتح ملحق Databricks ل Visual Studio Code على جهاز التطوير المحلي الخاص بك.
  4. في ملحق Databricks ل Visual Studio Code، انقر فوق الزر Configure في جزء Configuration . إذا لم يتم عرض الزر تكوين، فانقر فوق أيقونة الترس (تكوين مساحة العمل) بدلا من ذلك.
  5. في لوحة الأوامر، لمضيف Databricks، أدخل عنوان URL الخاص ب Azure Databricks لكل مساحة عمل، على سبيل المثال https://adb-1234567890123456.7.azuredatabricks.net، ثم اضغط على Enter.
  6. حدد إدخال ملف تعريف التكوين الذي يطابق الإدخال الذي قمت بإنشائه في الخطوة 2.
  7. أكمل الإرشادات التي تظهر على الشاشة في مستعرض الويب الخاص بك لإنهاء المصادقة باستخدام حساب Azure Databricks الخاص بك.

مصادقة Azure Databricks OAuth من مستخدم إلى جهاز (U2M)

يمكنك استخدام مصادقة Azure Databricks OAuth من مستخدم إلى جهاز (U2M) للمصادقة مع برنامج تشغيل Databricks ل SQLTools، كما يلي:

إشعار

تتوفر مصادقة Azure Databricks OAuth U2M في برنامج تشغيل Databricks لإصدارات SQLTools 0.4.2 وما فوق.

  1. تثبيت وفتح ملحق Databricks ل Visual Studio Code على جهاز التطوير المحلي الخاص بك.
  2. في ملحق Databricks ل Visual Studio Code، انقر فوق الزر Configure في جزء Configuration . إذا لم يتم عرض الزر تكوين، فانقر فوق أيقونة الترس (تكوين مساحة العمل) بدلا من ذلك.
  3. في لوحة الأوامر، لمضيف Databricks، أدخل عنوان URL الخاص ب Azure Databricks لكل مساحة عمل، على سبيل المثال https://adb-1234567890123456.7.azuredatabricks.net. ثم اضغط على مفتاح الإدخال Enter.
  4. حدد OAuth (المستخدم إلى الجهاز).
  5. أكمل الإرشادات التي تظهر على الشاشة في مستعرض الويب الخاص بك لإنهاء المصادقة باستخدام حساب Azure Databricks الخاص بك. إذا طلب منك ذلك، فاسمح بالوصول all-apis .

مصادقة Azure CLI

يمكنك استخدام Azure CLI للمصادقة مع برنامج تشغيل Databricks ل SQLTools، كما يلي:

إشعار

المصادقة باستخدام Azure CLI في حالة ميزة تجريبية. تتوفر هذه الميزة في Databricks Driver لإصدارات SQLTools 0.4.2 والإصدارات الأحدث.

  1. قم بتثبيت Azure CLI على جهاز التطوير المحلي الخاص بك، إذا لم تكن قد فعلت ذلك بالفعل.
  2. تثبيت وفتح ملحق Databricks ل Visual Studio Code على جهاز التطوير المحلي الخاص بك.
  3. في ملحق Databricks ل Visual Studio Code، انقر فوق الزر Configure في جزء Configuration . إذا لم يتم عرض الزر تكوين، فانقر فوق أيقونة الترس (تكوين مساحة العمل) بدلا من ذلك.
  4. في لوحة الأوامر، لمضيف Databricks، أدخل عنوان URL الخاص ب Azure Databricks لكل مساحة عمل، على سبيل المثال https://adb-1234567890123456.7.azuredatabricks.net. ثم اضغط على مفتاح الإدخال Enter.
  5. حدد Azure CLI.
  6. اتبع المطالبات التي تظهر على الشاشة لإنهاء المصادقة باستخدام Azure CLI.

الاتصال بمخطط

  1. في Visual Studio Code، على الشريط الجانبي، انقر فوق أيقونة SQLTools .
  2. في طريقة العرض SQLTools ، إذا كانت هذه هي المرة الأولى التي تستخدم فيها ملحق SQLTools، فانقر فوق إضافة اتصال جديد داخل جزء الاتصالات . وإلا، فانقر فوق أيقونة إضافة اتصال جديد في شريط عنوان الجزء.
  3. في علامة التبويب إعدادات SQLTools، لخطوة تحديد برنامج تشغيل قاعدة بيانات، انقر فوق أيقونة Databricks .
  4. بالنسبة لخطوة إعدادات الاتصال، أدخل المعلومات التالية حول المستودع والكتالوج والمخطط:

    1. بالنسبة إلى اسم الاتصال، أدخل اسما فريدا لهذا الاتصال.

    2. (اختياري) بالنسبة لمجموعة الاتصال، أدخل اسم مجموعة اتصال موجودة لإضافة الاتصال الجديد إلى تلك المجموعة. أو أدخل اسما فريدا لإنشاء مجموعة اتصال جديدة مع الاتصال الجديد. تسهل مجموعات الاتصال العثور على الاتصالات في الملحق.

    3. للاتصال باستخدام، حدد أحد الإجراءات التالية:

      • لاستخدام رمز وصول شخصي Azure Databricks للمصادقة، حدد اسم المضيف والرمز المميز.
      • بالنسبة لبرنامج تشغيل Databricks لإصدارات SQLTools 0.4.2 والإصدارات الأحدث، لاستخدام مصادقة OAuth U2M أو M2M أو Azure CLI، حدد ملحق VS Code (بيتا).

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

    5. بالنسبة إلى Path، أدخل إعداد مسار HTTP الخاص بالمستودع أو نظام المجموعة. للحصول على إعداد مسار HTTP للمستودع، راجع الحصول على تفاصيل الاتصال لمورد حساب Azure Databricks.

    6. إذا حددت اسم المضيف والرمز المميز للاتصال باستخدام، أدخل قيمة الرمز المميز للوصول الشخصي ل Azure Databricks في الرمز المميز.

    7. بالنسبة للكتالوج، أدخل اسم الكتالوج.

      إشعار

      بالنسبة لمساحات العمل غير الممكنة لكتالوج Unity، يمكنك ترك الكتالوج فارغا لاستخدام القيمة الافتراضية ل hive_metastore.

    8. بالنسبة للمخطط، أدخل اسم المخطط الخاص بك.

    9. (اختياري) بالنسبة إلى إظهار الحد الافتراضي للسجلات، اترك الإعداد الافتراضي 50 لإظهار حتى أول 50 صفا فقط لكل استعلام، أو أدخل حدا مختلفا.

  5. انقر فوق اختبار الاتصال.
  6. إذا نجح اختبار الاتصال، فانقر فوق حفظ الاتصال.

تغيير إعدادات الاتصال

يفترض هذا الإجراء أنك قمت بالاتصال بنجاح بمستودع واحد على الأقل.

  1. إذا لم تكن طريقة عرض SQLTools مرئية، ففي Visual Studio Code، على الشريط الجانبي، انقر فوق أيقونة SQLTools .
  2. في جزء Connections ، قم بتوسيع مجموعة الاتصال، إذا كان أحدها موجودا للاتصال الهدف.
  3. انقر بزر الماوس الأيمن فوق الاتصال، ثم انقر فوق تحرير الاتصال.
  4. تغيير إعدادات الهدف.
  5. انقر فوق اختبار الاتصال.
  6. إذا نجح اختبار الاتصال، فانقر فوق حفظ الاتصال.

استعراض كائنات المخطط

  1. في جزء Connections ، قم بتوسيع مجموعة الاتصال، إذا كان أحدها موجودا للاتصال الهدف.
  2. انقر نقرا مزدوجا فوق الاتصال الهدف لمستودعك أو قم بتوسيعه.
  3. قم بتوسيع قاعدة البيانات الهدف (المخطط)، إذا كانت موجودة لاتصالك.
  4. قم بتوسيع الجداول أو طرق العرض، إذا كان هناك جدول أو طرق عرض واحدة أو أكثر لقاعدة البيانات (المخطط).
  5. قم بتوسيع أي جدول أو طريقة عرض هدف لعرض أعمدة الجدول أو طريقة العرض.

عرض الصفوف أو المخططات لجدول أو طريقة عرض

مع توسيع الجداول أو طرق العرض في جزء الاتصالات ، قم بأحد الإجراءات التالية:

  • لإظهار صفوف الجدول أو طريقة العرض، انقر بزر الماوس الأيمن فوق الجدول أو طريقة العرض، ثم انقر فوق إظهار سجلات الجدول أو إظهار عرض السجلات.
  • لإظهار مخطط الجدول أو طريقة العرض، انقر بزر الماوس الأيمن فوق الجدول أو طريقة العرض، ثم انقر فوق وصف الجدول أو طريقة عرض الوصف.

إنشاء استعلام إدراج لجدول

  1. ضع المؤشر في محرر موجود في الموقع حيث تريد إضافة استعلام الإدراج.
  2. مع توسيع الجداول في جزء الاتصالات ، انقر بزر الماوس الأيمن فوق الجدول، وانقر فوق إنشاء استعلام إدراج. تتم إضافة تعريف استعلام الإدراج عند نقطة إدراج المؤشر.

إنشاء استعلام وتشغيله

يفترض هذا الإجراء أنك قمت بالاتصال بنجاح بمستودع واحد على الأقل.

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

تشغيل استعلام موجود

يفترض هذا الإجراء أنك قمت بالاتصال بنجاح بمستودع واحد على الأقل.

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

إرسال سجلات الاستخدام إلى Databricks

إذا واجهت مشكلات أثناء استخدام برنامج تشغيل Databricks ل SQLTools، يمكنك إرسال سجلات الاستخدام والمعلومات ذات الصلة إلى دعم Databricks عن طريق القيام بما يلي:

  1. تثبيت ملحق Databricks ل Visual Studio Code على جهاز التطوير المحلي.
  2. قم بتشغيل التسجيل عن طريق التحقق من الإعداد Logs: Enabled ، أو الإعداد databricks.logs.enabled إلى true، كما هو موضح في الإعدادات لملحق Databricks ل Visual Studio Code تأكد من إعادة تشغيل Visual Studio Code بعد تشغيل التسجيل.
  3. حاول إعادة إنتاج المشكلة.
  4. من لوحة الأوامر (عرض > لوحة الأوامر من القائمة الرئيسية)، قم بتشغيل الأمر Databricks: فتح السجلات الكاملة.
  5. أرسل الملفات Databricks Logs.logdatabricks-cli-logs.jsonو و sdk-and-extension-logs.json التي تظهر لدعم Databricks.
  6. انسخ أيضا محتويات المحطة الطرفية (عرض > المحطة الطرفية) في سياق المشكلة، وأرسل هذا المحتوى إلى دعم Databricks.

تعرض طريقة عرض الإخراج (عرض > الإخراج، سجلات Databricks) معلومات مقتطعة إذا تم تحديد السجلات: تم تحديد ممكن أو databricks.logs.enabled تم تعيينه إلى true. لإظهار مزيد من المعلومات، قم بتغيير الإعدادات التالية، كما هو موضح في الإعدادات لملحق Databricks ل Visual Studio Code:

  • السجلات: الحد الأقصى لطول الصفيف أو databricks.logs.maxArrayLength
  • السجلات: الحد الأقصى لطول الحقل أو databricks.logs.maxFieldLength
  • السجلات: عمق الاقتطاع أو databricks.logs.truncationDepth

الموارد الإضافية