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

نقطة نهاية SQL مورد حساب يتيح لك تشغيل أوامر SQL على كائنات البيانات داخل Databricks SQL. يقدم هذا المقال SQL نقاط النهاية ويصف كيفية العمل معها باستخدام Databricks SQL واجهة المستخدم. نقطة النهاية SQL هي نوع من مورد حساب Azure Databricks. تتضمن أنواع موارد الحوسبة الأخرى مجموعات Azure Databricks. للعمل مع SQL نقاط النهاية باستخدام API، راجع واجهات برمجة التطبيقات endpoints SQL 2.0.

قبل أن تبدأ

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

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

المتطلبات

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

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

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

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

انقر فوق Endpoints IconSQL نقاط النهاية في الشريط الجانبي.

بشكل افتراضي، يتم فرز نقاط النهاية حسب الحالة (تشغيل نقاط النهاية أولا)، ثم بالترتيب الأبجدي. يمكنك إعادة ترتيب القائمة بالنقر فوق عناوين الأعمدة.

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

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

Filter endpoints

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

Endpoint details

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

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

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

لإنشاء نقطة نهاية SQL باستخدام واجهة مستخدم الويب:

  1. انقر فوق Endpoints Icon-1SQL نقاط النهاية في الشريط الجانبي.

  2. انقر فوق إنشاء نقطة نهاية SQL لفتح مربع الحوار نقطة نهاية SQL الجديدة.

    Create endpoint

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

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

    • يمثل حجم الكتلة عدد العاملين في نظام المجموعة وحجم موارد الحوسبة المتوفرة لتشغيل الاستعلامات ولوحات المعلومات. الافتراضي هو X-كبير. لتقليل زمن وصول الاستعلام، قم بزيادة الحجم. للحصول على التفاصيل، راجع الحصة النسبية ل Azure vCPU المطلوبة.

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

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

    • تعيين التحجيم الحد الأدنى والحد الأقصى لعدد الكتل التي يتم توزيع الاستعلامات المرسلة إلى نقطة النهاية.

      الافتراضي هو الحد الأدنى من كتلة واحدة والحد الأقصى.

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

  5. (اختياري) تكوين خيارات متقدمة.

    إذا كنت تريد القيام بأي مما يلي، قم بتوسيع خيارات متقدمة:

    • إضافة علامات للمساعدة في مراقبة استخدام نقطة النهاية SQL
    • استخدام قناة المعاينة لاختبار الميزات القادمة

    للحصول على التفاصيل، راجع خيارات متقدمة.

  6. انقر فوق Create.

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

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

خيارات متقدمة

يمكنك تكوين الخيارات المتقدمة التالية عن طريق توسيع منطقة خيارات متقدمة عند إنشاء نقطة نهاية SQL باستخدام مربع الحوار نقطة النهاية SQL الجديدة أو تحرير نقطة نهاية SQL موجودة باستخدام مربع الحوار تحرير. يمكنك أيضا تكوين هذه الخيارات باستخدام واجهات برمجة التطبيقات endpoints SQL 2.0.

Configure advanced options

إضافة علامات لمراقبة الاستخدام

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

تكوين نهج المثيل الموضعي

تحدد سياسة المثيل الفوري ما إذا كان العمال يستخدمون مثيلات عند الطلب فقط أو مزيجا من المثيلات عند الطلب والمثيلات الفورية. يستخدم "تحسين التكلفة " (الافتراضي) في الغالب مثيلات موضعية ومثيل واحد عند الطلب. يستخدم "تحسين الموثوقية" مثيلات عند الطلب فقط.

استخدام قناة المعاينة

تتيح لك القنوات اختيار ما إذا كنت تريد استخدام إصدار حساب نقطة النهاية SQL الحالي أو إصدار المعاينة. تتيح لك نسخة المعاينة تجربة الوظائف قبل أن تصبح معيار Databricks SQL. استفد من قناة المعاينة لاختبار الاستعلامات ولوحات المعلومات الخاصة بك مقابل التغييرات القادمة. يمكنك التعرف على ما هو في أحدث إصدار معاينة في ملاحظات الإصدار.

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

هام

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

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

  1. انقر فوق Endpoints Icon-2SQL نقاط النهاية في الشريط الجانبي.
  2. لإيقاف تشغيل نقطة نهاية، انقر فوق إيقاف.
  3. لبدء نقطة نهاية متوقفة، انقر فوق ابدأ.
  4. لحذف نقطة نهاية، انقر فوق علامة القطع Vertical Ellipsis العمودية في عمود الإجراءات، ثم انقر فوق حذف.

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

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

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

لتحرير نقطة نهاية SQL باستخدام واجهة مستخدم الويب:

  1. انقر فوق Endpoints Icon-3SQL نقاط النهاية في الشريط الجانبي.

  2. في العمود إجراءات، انقر فوق القطع Vertical Ellipsis الناقص العمودي وانقر فوق تحرير.

  3. تحرير خصائص نقطة النهاية.

    للحصول على معلومات حول كل خاصية قابلة للتحرير، راجع إنشاء نقطة نهاية SQLوخيارات متقدمة.

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

تكوين أذونات نقطة النهاية SQL

لتكوين أذونات نقطة نهاية SQL:

  1. انقر فوق Endpoints Icon-4SQL نقاط النهاية في الشريط الجانبي.

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

  3. انقر فوق Permissions Button الزر .

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

    Add permission

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

  5. انقر فوق Add.

  6. انقر فوق Save.

للتعرف على مستويات الأذونات، راجع SQL عنصر تحكم الوصول إلى نقطة النهاية.

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

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

  1. انقر فوق Endpoints Icon-5SQL نقاط النهاية في الشريط الجانبي.

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

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

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

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

    Monitor endpoint

    ملاحظة

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

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

يعين الجدول في هذا المقطع أحجام كتلة نقطة النهاية 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 توجيه الاستعلامات كما يلي:

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