نقاط النهاية SQL

هام

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

نقطة نهاية SQL مورد حساب يتيح لك تشغيل أوامر SQL على كائنات البيانات داخل بيئة Azure Databricks.

SQL نقاط النهاية تظهر في سجل الاستعلام وتسجل المستخدم الذي قام بتشغيل الاستعلام.

تدعم نقاط النهاية SQL أوامر SQL في مرجع SQL ل Databricks SQL.

يصف هذا القسم كيفية العمل مع نقاط النهاية SQL باستخدام واجهة المستخدم. للعمل مع SQL نقاط النهاية باستخدام API، راجع واجهات برمجة التطبيقات SQL Endpoints.

تتم إدارة الاستعلامات من خلال نقاط النهاية SQL بواسطة "مراقبة الاستعلام" مع الإعدادات الافتراضية كما هو موضح في تلك المقالة.

المتطلبات

  • لإنشاء نقطة نهاية SQL يجب أن يكون لديك إذن إنشاء نظام المجموعة في Databricks هندسة علوم البيانات.

  • لإدارة نقطة نهاية SQL يجب أن يكون لديك إذن إدارة في Databricks SQL.

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

عرض نقاط النهاية SQL

انقر فوق رمز نقاط النهايةSQL نقاطالنهاية في الشريط الجانبي.

يتم فرز نقاط النهاية بشكل افتراضي بالترتيب الأبجدي. يمكنك إعادة ترتيب القائمة بالنقر فوق عناوين الأعمدة.

لمساعدتك على البدء بسرعة، مثل عند متابعة Quickstart: التعرف على SQL Databricks عن طريق استيراد لوحات المعلومات من معرض لوحة المعلومات النموذجية،يقوم Azure Databricks بإنشاء نقطة نهاية SQL صغيرة تسمى نقطة النهاية Starter تلقائيا. يمكنك تحرير نقطة النهاية SQL هذه أو حذفها.

لتصفية قائمة نقاط النهاية، أدخل نصا في مربع البحث:

تصفية نقاط النهاية

إنشاء نقطة نهاية SQL

يمكنك اختيار إنشاء نقطة نهاية SQL باستخدام تطبيق الويب أو واجهة برمجة تطبيقات endpoint SQL.

تنفيذ الخطوات التالية لإنشاء نقطة نهاية SQL باستخدام تطبيق ويب.

  1. انقر فوق رمز نقاط النهايةSQL نقاطالنهاية في الشريط الجانبي.

  2. انقر فوق + نقطة نهاية SQL جديدة.

    إنشاء نقطة النهاية

  3. أدخِل اسماً لنقطة النهاية.

  4. قبول خصائص نقطة النهايةأو تحريرها .

  5. انقر فوق ⁧⁩Create⁧⁩.

  6. قم بتنفيذ أحد الإجراءات الآتية:

    نقطة النهاية يتم إنشاؤها وبدء تشغيلها.

بدء نقطة نهاية SQL أو إيقافها أو حذفها

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

راجع أيضا تكوين أساس خدمة.

تحرير نقطة نهاية SQL

يمكنك اختيار تحرير نقطة نهاية SQL باستخدام تطبيق الويب أو واجهة برمجة تطبيقات endpoint SQL.

قم بتنفيذ الخطوات التالية لتحرير نقطة نهاية SQL باستخدام تطبيق الويب.

  1. انقر فوق رمز نقاط النهايةSQL نقاطالنهاية في الشريط الجانبي.
  2. انقر فوق نقطة نهاية.
  3. انقر فوق الزر "Edit" .
  4. تحرير خصائص نقطة النهاية.
    • حجم الكتلة: عدد العاملين في المجموعة وحجم المنسق. الافتراضي هو X-كبير. لتقليل زمن وصول الاستعلامات، قم بزيادة الحجم. حجم أكبر لديه منسق أكبر ويضاعف عدد العاملين في المجموعة. لمزيد من التفاصيل، راجع الحصة النسبية المطلوبة ل Azure vCPU.

    • إيقاف تلقائي: ما إذا كانت نقطة النهاية ستتوقف إذا كانت خاملة لعدد الدقائق المحدد. الافتراضي قيد التشغيل بقيمة 120 دقيقة.

      ملاحظة

      تستمر نقاط النهاية SQL الخاملة في تجميع رسوم DBU ومثيل السحابة حتى يتم إيقافها.

    • موازنة تحميل متعددة الكتل:الحد الأدنى والحد الأقصى لعدد المجموعات التي يتم توزيع الاستعلامات المرسلة إلى نقطة النهاية. الافتراضي هو إيقاف مع حد أقصى من كتلة 1. عند تعيين إلى تشغيل، يكون الافتراضي هو الحد الأدنى 1 الكتلة و 2 الحد الأقصى للتجمعات.

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

    • فوتون: ما إذا كان يتم تنفيذ الاستعلامات على مشغل فوتون الأصلي المتجهة التي تسرع تنفيذ الاستعلام. الافتراضي هو تشغيل.

      لعرض مقدار الاستعلام الذي تم عرضه باستخدام فوتون:

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

      بشكل عام، كلما كانت النسبة المئوية لوقت المهمة في فوتون أكبر، كلما زاد أداء الفوتون.

    • الأذونات: المستخدمون والمجموعات التي يمكنها إدارة نقطة النهاية واستخدامها.

    • العلامات: التعليقات التوضيحية لزوج القيمة الرئيسية التي يمكنها تحديد من يستخدم نقطة النهاية.

  5. انقر فوق حفظ أو حفظ وإعادة تشغيل.

تحرير أذونات نقطة النهاية

لتحرير أذونات نقطة النهاية:

  1. انقر فوق الزر أذونات الزر.

    يتم عرض أذونات نقطة النهاية SQL. منشئ نقطة النهاية ومسؤولين Azure Databricks لديهم إذن "إدارة".

    إضافة إذن

  2. حدد مستخدم أو مجموعة وأذونات.

  3. انقر فوق Add.

  4. اضغط على حفظ .

إضافة علامة نقطة نهاية

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

لإضافة علامة نقطة نهاية:

  1. انقر فوق رمز نقاط النهايةSQL نقاطالنهاية في الشريط الجانبي.

  2. انقر فوق نقطة نهاية.

  3. انقر فوق الزر "Edit" .

  4. في الصف علامات، أدخل مفتاح العلامة والقيمة.

    إضافة علامة

  5. انقر فوق حفظ وإعادة تشغيل.

مراقبة نقطة نهاية SQL

يمكنك فحص عدد الاستعلامات التي تمت معالجتها بواسطة نقطة النهاية وعدد الكتل المخصصة لنقطة النهاية.

  1. انقر فوق رمز نقاط النهايةSQL نقاطالنهاية في الشريط الجانبي.

  2. انقر فوق نقطة نهاية.

  3. انقر فوق مراقبة.

    يعرض مخطط يوضح عدد الاستعلامات التي تمت معالجتها بواسطة نقطة النهاية وعدد الكتل المخصصة لنقطة النهاية خلال الساعات الست الأخيرة.

    انقر فوق زر مقياس زمني في أعلى يمين المخطط لتغيير الفترة المعروضة. على سبيل المثال، تظهر لقطة الشاشة التالية هذه الإحصائيات على مدار 7 أيام:

    نقطة نهاية الشاشة

    ملاحظة

    يمكن أن يكون عدد الكتلة أكبر من واحد فقط إذا تم تمكين موازنة تحميل الكتلة المتعددة وتكوينها.

حجم نظام المجوعة

يعين الجدول في هذا المقطع أحجام كتلة نقطة النهاية SQL إلى حجم برنامج تشغيل الكتلة Azure Databricks وأعداد العاملين.

حجم نظام المجوعة حجم برنامج التشغيل عدد العاملين
2X-صغيرة Standard_E8ds_v4 1
X-الصغيرة Standard_E8ds_v4 2
صغير Standard_E16ds_v4 4
متوسط Standard_E32ds_v4 8
كبير Standard_E32ds_v4 ⁧⁩16⁧⁩
X-كبير Standard_E64ds_v4 32
2X-كبير Standard_E64ds_v4 64
3X-كبير Standard_E64ds_v4 128
4X-كبير Standard_E64ds_v4 256

حجم المثيل من جميع العمال هو Standard_E8ds_v4.

لدى كل برنامج تشغيل وعامل ثمانية أقراص مدارة LRS قياسية 128 غيغابايت مرفقة. يتم احتساب الأقراص المرفقة كل ساعة.

الحصة النسبية المطلوبة ل Azure vCPU

لبدء نقطة نهاية SQL، يجب أن يكون لديك حصة نسبية كافية من Azure vCPU Standard_E8ds_v4 مثيلات في حساب Azure. استخدم الإرشادات التالية لتحديد الحصة النسبية vCPU المطلوبة:

  • إذا كان لديك نقطة نهاية واحدة أو نقطتي نهاية SQL فقط، فتأكد من توفر 8 Azure vCPU لكل نواة في الكتلة. وهذا يضمن أن لديك vCPU Azure كافية لحساب إعادة توفير نقطة النهاية الخاصة بك الذي يحدث تقريبا كل 24 ساعة. إذا كانت نقاط النهاية SQL تستخدم موازنة التحميل التلقائي أو متعدد الكتل، فقد تحتاج إلى زيادة المضاعف.
  • كما يزيد عدد نقاط النهاية SQL، تسمح ل بين 4 و 8 VCPU أزور لكل الأساسية في الكتلة. توصي ستريك البيانات بالبدء بعدد أكبر ومراقبة الاستقرار.
  • وحدات vCPUs Azure المستخدمة من قبل نقاط النهاية SQL بالإضافة إلى وحدات vCPUs Azure المستخدمة من قبل المجموعات المستخدمة من قبل هندسة علوم البيانات & أو من قبل أحمال العمل غير Databricks.

لطلب حصة إضافية من Azure vCPU، راجع الحصة النسبية القياسية: زيادة الحدود حسب سلسلة VM في وثائق Azure.

وضع قائمة انتظار والتحجيم التلقائي

تحدد Azure Databricks عدد الاستعلامات على كتلة معينة إلى نقطة نهاية SQL إلى 10. يعتمد رفع حجم الكتل لكل نقطة نهاية على سرعة نقل الاستعلام ومعدل الاستعلامات الواردة وحجم قائمة الانتظار. يضيف Azure Databricks الكتل استنادا إلى الوقت الذي سيستغرقه لمعالجة كافة الاستعلامات قيد التشغيل حاليا كافة الاستعلامات في قائمة الانتظار والاستعلامات الواردة المتوقعة في الدقيقتين التاليتين كما يلي:

  • أقل من دقيقتين، لا راقية.
  • 2 إلى 6 دقائق، إضافة 1 الكتلة.
  • 6 إلى 12 دقيقة، إضافة 2 مجموعات.
  • 12 إلى 22 دقيقة، إضافة 3 مجموعات.

وإلا، يضيف Azure Databricks 3 مجموعات بالإضافة إلى كتلة واحدة لكل 15 دقيقة إضافية من تحميل الاستعلام المتوقع.

بالإضافة إلى ذلك، يتم دائما رفع مستوى نقطة النهاية إذا انتظر استعلام لمدة 5 دقائق في قائمة الانتظار.

إذا كان التحميل منخفضا لمدة 15 دقيقة، يقوم Azure Databricks بمقياس نقطة النهاية SQL. يحتفظ كتل كافية لمعالجة التحميل الذروة خلال الدقائق ال 15 الماضية. على سبيل المثال، إذا كان التحميل الذروة 25 الاستعلامات المتزامنة يحتفظ Azure Databricks 3 مجموعات.

وضع الاستعلام في قائمة الانتظار

Azure Databricks قوائم الانتظار الاستعلامات عندما تقوم كافة الكتل المعينة إلى نقطة النهاية حاليا بتنفيذ 10 استعلامات أو عند نقطة النهاية في STARTING الحالة.

استعلامات بيانات التعريف (على سبيل DESCRIBE <table> المثال، ) وحالة تعديل الاستعلامات (على سبيل SET المثال) يتم أبدا في قائمة الانتظار، إلا إذا كانت نقطة النهاية في STARTING الحالة.

توجيه الاستعلام

Azure Databricks توجيه الاستعلامات كما يلي:

  • جلسة عمل جديدة: إلى الكتلة مع تحميل أقل.
  • جلسة العمل الحالية: إلى الكتلة التي قامت بتشغيل الاستعلام السابق لجلسة العمل تلك. إذا لم يكن نظام المجموعة هذه سعة متوفرة، يتم توجيه الاستعلام إلى الكتلة مع تحميل أقل.