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

عند إنشاء موصل منتدى، فإن كل حقل تحدده في المخطط تتطلب نوع بيانات. يحدد نوع البيانات النوع الأساسي للحقل مثل "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 الكشف عنها تلقائيًا استنادًا إلى data type والتنسيق قيم البيانات التي يعرضها الموصل.

ملاحظة: لا يتم تنفيذ الكشف التلقائي عن النوع الدلالي إلا عندما لا تحتوي أي حقول على تم العثور على 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)