الاتصال ب SQL Workbench/J

توضح هذه المقالة كيفية استخدام SQL Workbench/J مع Azure Databricks.

إشعار

تتناول هذه المقالة SQL Workbench/J، والتي لا يتم توفيرها أو دعمها من قبل Databricks. للاتصال بالموفر، راجع استخدام منتدى دعم SQL Workbench/J في Google Groups.

المتطلبات

  • SQL Workbench/J.

  • برنامج تشغيل Databricks JDBC. قم بتنزيل برنامج تشغيل Databricks JDBC على جهاز التطوير المحلي الخاص بك، واستخراج DatabricksJDBC42.jar الملف من الملف الذي تم تنزيله DatabricksJDBC42-<version>.zip .

    إشعار

    تم اختبار هذه المقالة مع macOS وSQL Workbench/J Build 130 و Zulu OpenJDK 21.0.1 وDatabricks JDBC Driver 2.6.36.

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

  • مجموعة أو مستودع SQL في مساحة عمل Azure Databricks.

  • تفاصيل الاتصال لنظام المجموعة أو مستودع SQL، وتحديدا قيم Server Hostname وPort وHTTP Path.

  • رمز مميز للوصول الشخصي إلى Azure Databricks أو رمز مميز لمعرف Microsoft Entra (المعروف سابقا ب Azure Active Directory). لإنشاء رمز مميز للوصول الشخصي، قم بما يلي:

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

    إشعار

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

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

    إشعار

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

خطوات الاتصال ب Workbench/J

للاتصال ب Workbench/J، قم بما يلي:

  1. قم بتشغيل SQL Workbench/J.
  2. حدد نافذة File > Connect.
  3. في مربع الحوار تحديد ملف تعريف الاتصال، انقر فوق إدارة برامج التشغيل.
    1. في حقل الاسم، اكتب Databricks.
    2. في حقل المكتبة ، انقر فوق الأيقونة تحديد ملف (ملفات) JAR. استعرض للوصول إلى الدليل حيث قمت باستخراج DatabricksJDBC42.jar الملف من الملف الذي تم تنزيله DatabricksJDBC42-<version>.zip ، وحدد ملف JAR. ثم انقر فوق اختيار.
    3. تحقق من ملء الحقل Classname ب com.databricks.client.jdbc.Driver.
    4. وانقر فوق موافق.
  4. انقر فوق أيقونة إنشاء ملف تعريف اتصال جديد.
    1. اكتب اسما لملف التعريف.
    2. في حقل برنامج التشغيل، حدد Databricks (com.databricks.client.jdbc.Driver).
    3. في حقل URL ، أدخل عنوان URL ل JDBC لمورد Azure Databricks. للحصول على بناء جملة حقل URL لعناوين URL ل JDBC، راجع إعدادات المصادقة لبرنامج تشغيل Databricks JDBC.
    4. انقر فوق اختبار.
    5. انقر فوق موافق مرتين.

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