أنواع البيانات والدلالية

عند إنشاء أداة ربط خاصة بالمنتدى، يتطلّب كل حقل تحدّده في المخطّط نوع بيانات. يحدّد نوع البيانات النوع الأساسي للحقل، مثل BOOLEAN أو STRING أو NUMBER وما إلى ذلك.

بالإضافة إلى أنواع البيانات، تستخدم أداة Looker Studio أيضًا الأنواع الدلالية. تساعد الأنواع الدلالية في وصف نوع المعلومات التي تمثّلها البيانات. على سبيل المثال، قد يمثّل حقل من نوع البيانات NUMBER بشكل دلالي مبلغًا من العملة أو نسبة مئوية، وقد يمثّل حقل من نوع البيانات STRING بشكل دلالي مدينة. لمعرفة أنواع البيانات الدلالية المتوفّرة، يُرجى الرجوع إلى مستندات أنواع البيانات الدلالية.

مخطط موصّل البيانات من إنشاء المنتدى وحقول Looker Studio

عند تحديد المخطط لموصلك الخاص، تتوفّر سمات مختلفة لكل حقل تحدّد طريقة عرض الحقل واستخدامه في Looker Studio. على سبيل المثال:

• يتم تحديد conceptType في مخطط الموصل باستخدام السمة conceptType. تحدّد هذه السمة ما إذا كان الحقل سيُعامل كسمة أو مقياس. يمكنك الاطّلاع على شرح للفرق بين المقاييس والسمات في مقالة السمات والمقاييس.
• يمكن تحديد النوع الدلالي في مخطط أداة الربط، أو يمكن أن ترصده أداة Looker Studio تلقائيًا استنادًا إلى خاصية نوع البيانات المحدّدة في أداة الربط وقيم البيانات التي تعرضها أداة الربط. راجِع مقالة الرصد التلقائي للنوع الدلالي للحصول على تفاصيل حول طريقة عمل هذه الميزة.
• يحدّد نوع التجميع ما إذا كان يمكن إعادة تجميع قيم المقياس (يتم تجاهل السمات). عند ضبط السمة semantics.isReaggregatable على true، سيتم تلقائيًا استخدام التجميع SUM، وإلا سيتم ضبطها على Auto. يمكنك أيضًا ضبط نوع التجميع التلقائي يدويًا للحقول القابلة لإعادة التجميع باستخدام السمة defaultAggregationType.

عند ضبط أداة ربط واستخدامها في Looker Studio، يعرض محرّر الحقول المخطط الكامل لأداة الربط استنادًا إلى طريقة تحديد الخصائص المذكورة أعلاه. إذا كنت قد أدرجت الأنواع الدلالية، ستظهر كما حدّدتها. في حال استخدامك الرصد التلقائي للنوع الدلالي، ستظهر الحقول كما تم رصدها.

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

ضبط المعلومات الدلالية

هناك طريقتان لضبط المعلومات الدلالية. يمكنك ضبط دلالات الحقول يدويًا أو الاعتماد على Looker Studio في رصدها تلقائيًا.

على سبيل المثال، إذا كان لديك رقم يمثّل دلاليًا الدولار الأمريكي، لن يتمكّن Looker Studio من رصد هذا النوع الدلالي تلقائيًا. بالإضافة إلى ذلك، يتطلّب الاكتشاف التلقائي للدلالات أن يطلب Looker Studio جلب البيانات لكل حقل من حقول المخطط. إذا حدّدت المخطط يدويًا، لن يتم إجراء أي طلبات لجلب البيانات. في حال معرفة النوع الدلالي (مثل العملة أو النسبة المئوية أو التاريخ وما إلى ذلك) لبياناتك، ننصحك بتحديد ذلك بشكل صريح في المخطط لأسباب تتعلّق بالدقة والأداء.

ضبط الأنواع الدلالية يدويًا (يُنصح به)

إذا كنت تعرف أنواعك الدلالية، يمكنك تحديد semantics يدويًا لكل حقل من حقول المخطط. يمكنك الاطّلاع على التفاصيل الكاملة حول الخصائص المتاحة لك في صفحة مرجع الحقول. إذا اخترت تحديد أنواع دلالية يدوية، ننصحك بتحديد semanticType وsemanticGroup لكل حقل. من خلال تقديم هذه الخصائص يدويًا، لن يتم تشغيل عملية التعرّف التلقائي على النوع الدلالي. إذا ضبطت بعض الحقول يدويًا، ولكن ليس كلها، سيتم ضبط الحقول التي لم تحدّدها تلقائيًا على Text أو Number أو Boolean استنادًا إلى dataType المحدّد للحقل.

في ما يلي مثال على مخطط بسيط يضبط الأنواع الدلالية يدويًا. تم ضبط Income كعملة، وتم ضبط Filing Year كتاريخ.

data-studio/semantics.gs

عرض على GitHub

var schema = [
  {
    'name': 'Income',
    'label': 'Income (in USD)',
    'dataType': 'NUMBER',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'CURRENCY',
      'semanticType': 'CURRENCY_USD'
    }
  }, {
    'name': 'Filing Year',
    'label': 'Year in which you filed the taxes.',
    'dataType': 'STRING',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'DATE_OR_TIME',
      'semanticType': 'YEAR'
    }
  }
];

تحديد المشاكل في الأنواع الدلالية اليدوية وحلّها

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

1. يمكنك عرض صفَين أو 3 صفوف من بياناتك بدلاً من عرضها كلها، ثم فحصها يدويًا.
2. أنشئ جدولاً في Looker Studio يستخدم الحقل الذي تحاول التحقّق منه فقط.
3. يجب الانتباه جيدًا إلى الحقلَين Geo وDate لأنّ تنسيقهما هو الأكثر صرامة.

التعرّف التلقائي على النوع الدلالي

إذا لم تحدّد أي أنواع دلالية في المخطط، ستحاول Looker Studio رصدها تلقائيًا استنادًا إلى السمة نوع البيانات وتنسيق قيم البيانات التي يعرضها الموصل.

ملاحظة: لا يتم إجراء عملية الرصد التلقائي للنوع الدلالي إلا عند عدم العثور على أي حقول تحتوي على semanticType وعند إنشاء مصدر بيانات جديد أو تغيير مخطط مصدر بيانات حالي فقط.

في ما يلي خطوات عملية الرصد التلقائي:

1. اطلب المخطط عن طريق تنفيذ الدالة getSchema الخاصة برابطك المخصص للمنتدى.
2. كرِّر مجموعات الحقول المحدّدة في مخطط الموصل وأرسِل طلبات getData للحقول. يتم تنفيذ طلبات getData مع ضبط المَعلمة sampleExtraction على القيمة true للإشارة إلى أنّ طلبات البيانات مخصّصة لأغراض الرصد الدلالي.
3. استنادًا إلى نوع بيانات الحقل وتنسيق القيمة التي يتم عرضها من طلب getData، حدِّد النوع الدلالي للحقل.

تنبيه: لا يمكن للتعرّف التلقائي على النوع الدلالي تحديد جميع الأنواع الدلالية لمخططك بشكل صحيح. يمكنه رصد الأنواع الدلالية الخاصة بالوقت/التاريخ والجغرافيا فقط.

خيارات معالجة ميزة "التعرّف التلقائي على النوع الدلالي"

عندما تنفّذ أداة Looker Studio الدالة getData لموصّل بيانات من إنشاء المنتدى بغرض رصد المعاني، سيتضمّن الطلب الوارد السمة sampleExtraction التي سيتم ضبطها على true. لا تستخدم أداة Looker Studio البيانات التي يعرضها الموصّل إلا لتحديد النوع الدلالي للحقل. وبما أنّ القيمة لن تُستخدَم لأي غرض آخر، لا تتطلّب بيانات فعلية من مصدرك الخارجي.

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

• يُنصح بما يلي: تمرير قيم محدّدة مسبقًا
  يجب عرض قيمة محدّدة مسبقًا لكل حقل تمثّل بشكل أفضل النوع الدلالي للحقل، ويجب أن يكون هذا النوع معروفًا بأنّه يتم رصده بشكل صحيح من خلال Looker Studio. على سبيل المثال، إذا كان النوع الدلالي لحقل هو البلد، يجب عرض قيمة مثل IT لإيطاليا. من المزايا الأخرى لهذا الأسلوب أنّه أسرع بكثير لأنّه لا يتطلّب منك إرسال طلبات HTTP إلى الخدمة الخارجية للحصول على البيانات.

• إرجاع n عدد السجلات فقط
  إذا كانت الخدمة التابعة لجهة خارجية التي تستردّ منها البيانات تتيح وضع حدود على عدد الصفوف عند طلب البيانات، يمكنك إرجاع مجموعة فرعية صغيرة من الصفوف إلى Looker Studio بدلاً من مجموعة البيانات الكاملة. سيؤدي ذلك إلى الحدّ من كمية البيانات التي تحتاج إلى تمريرها إلى Looker Studio لكل طلب رصد دلالي.

• طلب جميع الأعمدة وتخزين الرد مؤقتًا
  إذا كان من الممكن طلب جميع الأعمدة لخدمة الطرف الثالث التي تسترد منها البيانات، عند تلقّي أول طلب رصد دلالي من Looker Studio، استردّ جميع الأعمدة وخزِّن النتائج مؤقتًا. بالنسبة إلى طلبات الرصد الدلالي اللاحقة، يتم استرداد قيم الأعمدة من ذاكرة التخزين المؤقت بدلاً من إرسال طلبات HTTP إضافية إلى الخدمة التابعة لجهة خارجية.

• عدم اتّخاذ أي إجراء مختلف
  يمكنك اختيار عدم اتّخاذ أي إجراء محدّد للطلبات التي تم فيها ضبط قيمة sampleExtraction على true. سيؤدي ذلك إلى إبطاء عملية "الرصد الدلالي" لأنّ Looker Studio سيضطر إلى استرداد جميع البيانات اللازمة لهذه العملية. بالإضافة إلى ذلك، سيؤثر ذلك في معدّل الطلبات إلى مصدر البيانات الخارجي لأنّه سيتم تنفيذ العديد من طلبات الرصد الدلالي بشكل متزامن.

التنسيقات المعترف بها للتعرّف التلقائي على النوع الدلالي

التاريخ والوقت

• YYYY/MM/DD-HH:MM:SS
• YYYY-MM-DD [HH:MM:SS[.uuuuuu]]
• YYYY/MM/DD [HH:MM:SS[.uuuuuu]]
• YYYYMMDD [HH:MM:SS[.uuuuuu]]
• Sat, 24 May 2008 20:09:47 GMT
• 2008-05-24T20:09:47Z
• الوقت: حقبة بالثانية والمايكرو ثانية والملّي ثانية والنانو ثانية

الموقع الجغرافي

• اسم القارة أو رمزها
• اسم شبه القارة أو رمزها
• اسم المنطقة أو رمزها
• اسم البلد أو رمزه: يمكنك أيضًا الاطّلاع على ISO_3166-1.
• اسم المدينة
• قيمة خط العرض وخط الطول مفصولة بفواصل
• اسم منطقة التسويق المحدّدة ورمزها