استخدام معلمات لوحة المعلومات

  • مقالة

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

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

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

إضافة معلمة

يجب أن يكون لديك على الأقل Can Edit permissions على لوحة معلومات المسودة لإضافة معلمة إلى مجموعة بيانات لوحة المعلومات. يمكنك إضافة معلمات مباشرة إلى استعلامات مجموعة البيانات في علامة التبويب البيانات .

يعرض Gif مثالا على الخطوات التالية.

لإضافة معلمة إلى استعلام:

  1. ضع المؤشر في المكان الذي تريد وضع المعلمة فيه في الاستعلام.

  2. انقر فوق إضافة معلمة لإدراج معلمة جديدة.

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

تحرير معلمة

لتحرير معلمة:

  1. انقر أيقونة الترس إلى جانب اسم المعلمة. يظهر مربع حوار تفاصيل المعلمة.

    يتضمن مربع الحوار خيارات التكوين التالية:

    • الكلمة الأساسية: الكلمة الأساسية التي تمثل المعلمة في الاستعلام. يمكن تغيير هذا فقط عن طريق تحديث النص مباشرة في الاستعلام.
    • اسم العرض: الاسم في محرر عامل التصفية. بشكل افتراضي، يكون العنوان هو نفس الكلمة الأساسية.
    • النوع: تتضمن الأنواع المدعومة السلسلة والتاريخ والتاريخ والوقت والرقم.
      • النوع الافتراضي هو String.
      • يسمح لك نوع البيانات الرقمي بتحديد بين عشري وأعداد صحيحة. النوع الرقمي الافتراضي هو عشري.

  2. انقر فوق جزء آخر من واجهة المستخدم لإغلاق مربع الحوار.

إزالة معلمة

لإزالة معلمة، احذفها من الاستعلام.

استخدام معلمة على لوحة المعلومات

لإضافة معلمة إلى لوحة المعلومات:

  1. انقر فوق أيقونة عامل التصفيةإضافة عامل تصفية (حقل/معلمة).
  2. انقر بجوار أيقونة إضافة حقلParameters في لوحة التكوين.
  3. انقر فوق اسم المعلمة الذي تريد أن يستخدمه العارض مع عنصر واجهة المستخدم هذا.

تضمين المعلمات في عنوان URL

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

أمثلة على بناء جملة المعلمة

(1) يتم إدراج القيم باستخدام الدالة format_string . راجع الدالة format_string.

توفر الأمثلة التالية حالة استخدام متبوعة بنموذج بناء الجملة.

  • قم بتضمين السجلات قبل تاريخ معين فقط.

    WHERE date_field < :date_param

  • قم بتضمين الأسعار التي تقل عن سعر معين فقط.

    WHERE price < :max_price

  • حدد الجدول الذي تريد استخدامه في استعلام.

    SELECT * FROM IDENTIFIER(:param)

  • تغيير الكتالوج والمخطط والجدول المستخدم في استعلام.

    SELECT * FROM IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

  • ادمج معلمتين مع قوسين لإنشاء أرقام هواتف منسقة.

    يستخدم المثال التالي الدالة format_string لإدراج القيم. راجع الدالة format_string.

    format_string('(%d) %d', :area_code, :phone_number)

هام

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

معلمات لوحة المعلومات مقابل معلمات استعلام Databricks SQL

تستخدم معلمات لوحة المعلومات نفس بناء الجملة مثل علامات المعلمات المسماة. راجع علامات المعلمات المسماة. لا تدعم لوحات المعلومات معلمات نمط Databricks SQL.