Share via

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

  • مقالة

هام

هذه الميزة في وضع المعاينة حاليًا. تتضمن شروط الاستخدام التكميلية لمعاينات Microsoft Azure المزيد من الشروط القانونية التي تنطبق على ميزات Azure الموجودة في الإصدار التجريبي أو قيد المعاينة أو التي لم يتم إصدارها بعد في التوفر العام. للحصول على معلومات حول هذه المعاينة المحددة، راجع معلومات معاينة Azure HDInsight على AKS. للأسئلة أو اقتراحات الميزات، يرجى إرسال طلب على AskHDInsight مع التفاصيل ومتابعتنا لمزيد من التحديثات على مجتمع Azure HDInsight.

يدعم Trino وحدات استماع الأحداث المخصصة التي يمكن استخدامها للاستماع إلى أحداث دورة حياة الاستعلام. يمكنك تأليف مستمعي الأحداث الخاصين بك أو استخدام مكون إضافي مضمن يوفره HDInsight على AKS الذي يسجل الأحداث إلى Azure Blob Storage.

يمكنك تمكين تسجيل الاستعلام المضمن بطريقتين:

  • يمكنك تمكين تسجيل الاستعلام المضمن أثناء إنشاء مجموعة Trino عن طريق تمكين كتالوج الخلية.

  • يمكنك تمكين تسجيل الاستعلام المضمن في نظام المجموعة باستخدام قالب ARM.

تتناول هذه المقالة إضافة تسجيل الاستعلام إلى نظام المجموعة باستخدام قالب ARM.

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

تمكين تسجيل الاستعلام

لتمكين المكون الإضافي لتسجيل الاستعلام المضمن في مجموعة Trino، أضف/حدث clusterProfile.trinoProfile.userTelemetrySpec القسم بالخصائص التالية في قالب ARM لنظام المجموعة.

الخاصية ‏‏الوصف
path مسار مؤهل بالكامل إلى دليل يستخدم كجذر لالتقاط سجلات استعلام مختلفة.
hivecatalogName يستخدم هذا الكتالوج لتحميل جداول خارجية على الملفات المكتوبة في حساب التخزين. يجب إضافة هذا الكتالوج في نظام المجموعة الخاص بك، إضافة كتالوج الخلية.
hivecatalogSchema يستخدم المكون الإضافي لتسجيل الاستعلام هذا المخطط لتحميل الجدول الخارجي للسجلات، يقوم المكون الإضافي بإنشاء هذا المخطط إذا لم يكن موجودا بالفعل. القيمة الافتراضية - trinologs
partitionRetentionInDays يقوم المكون الإضافي لتسجيل الاستعلام بتقليم الأقسام في جداول السجل، الأقدم من التكوين المحدد. القيمة الافتراضية - 365

يوضح المثال التالي كيفية تمكين تسجيل استعلام في مجموعة Trino. أضف نموذج json هذا ضمن [*].properties.clusterProfile في قالب ARM.

       "trinoProfile": { 
          "userTelemetrySpec": { 
          "storage": { 
              "path": "https://querylogstorageaccount.blob.core.windows.net/logs/trinoquerylogs", 
              "hivecatalogName": "hive", 
              "hivecatalogSchema": "trinologs", 
              "partitionRetentionInDays": 365 
          } 
          }
      }

انشر قالب ARM المحدث ليعكس التغييرات في نظام المجموعة. تعرف على كيفية نشر قالب ARM.

إشعار

  • يستخدم المكون الإضافي الهوية المدارة المعينة من قبل المستخدم (MSI) المرتبطة بالمجموعة للمصادقة مقابل التخزين، يرجى إضافة Contributor والوصول Storage Blob Data Owner إلى MSI للتأكد من أن المكون الإضافي يمكنه كتابة السجلات إلى حساب التخزين.
    يتم سرد اسم MSI المعين من قبل المستخدم في الخاصية msiResourceId في مورد نظام المجموعة JSON. تعرف على كيفية تعيين دور.

  • يقوم PartitionRetentionInDays بإزالة قسم بيانات التعريف فقط من الجدول المحمل، ولا يحذف البيانات. يرجى تنظيف البيانات وفقا لمتطلباتك إذا لم تعد هناك حاجة إليها.

إدارة بيانات التعريف

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

ينشئ المكون الإضافي ثلاثة جداول وثلاث طرق عرض، والتي يمكن استخدامها للاستعلام عن أحداث دورة الحياة (QueryCompletedEventو QueryCreatedEventو).SplitCompletedEVent يتم إنشاء هذه الجداول وطرق العرض ضمن الكتالوج والمخطط المقدم كإدخال المستخدم.

اسم الجداول:

  • querycompleted: يحتوي على QueryCompleted أحداث تم إطلاقها بواسطة Trino.
  • querycreated: يحتوي على QueryCreatedEvents تم تشغيله بواسطة Trino.
  • splitcompleted: يحتوي على SplitCompletedEvents تم تشغيله بواسطة Trino.

اسم طرق العرض:

  • vquerycompleted
  • vquerycreated
  • vsplitcompleted

إشعار

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

أرشفة الجدول

يدعم المكون الإضافي أرشفة الجدول (N-1) في السيناريو حيث يقرر المستخدم تغيير path أو الموقع الخارجي للسجلات. إذا حدث ذلك، يعيد المكون الإضافي تسمية الجدول الذي يشير إلى المسار القديم على أنه <table_name>_archived، فإن طريقة العرض التي تم إنشاؤها ستوحد نتيجة الجداول الحالية والجداول المؤرشفة في هذا السيناريو.

إنشاء المكون الإضافي المخصص

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