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

عند إنشاء موصل منتدى، يتطلب كل حقل تحدده في المخطط نوع بيانات. يحدّد نوع البيانات النوع الأساسي للحقل مثل 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. اعرض صفين أو ثلاثة من بياناتك بدلاً من عرضها كلها، ثم افحصها يدويًا.
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 على سبيل المثال، إذا كان النوع الدلالي للحقل هو Country (البلد)، يجب عرض قيمة مثل 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.
• اسم المدينة
• قيمة خط العرض وخط الطول مفصولة بفاصلة
• اسم ورمز منطقة التسويق المحددة (DMA)