Ingestion Viewer

توفّر "أداة عرض عملية الاستيعاب" (التي يمكن الوصول إليها ضمن الاستيعاب > السجلّ في "مركز الإجراءات") إمكانية الاطّلاع في الوقت الفعلي تقريبًا على الحالة وسلامة التحقّق من الصحة وسجلّ المعالجة لخلاصات نقاط الاهتمام المحلية.

استخدِم "أداة عرض عملية استيعاب البيانات" لتتبُّع عمليات تحميل الخلاصة اليومية، ومراقبة سلامة عملية الاستيعاب، والاطّلاع على إحصاءات أخطاء التحقّق من الصحة على مستوى السلعة، والتحقّق من وصول ملفات الخلاصة.

نظرة عامة

تعرض صفحة "أداة عرض بيانات التجميع" الرئيسية سجلّاً بترتيب زمني عكسي لكل خلاصة تلقّلتها Google.

مراحل دورة حياة النقل

تتضمّن عملية إرسال كل خلاصة مراحل المعالجة المتسلسلة التالية:

1. الحصول على الملف: تتلقّى Google ملف الخلاصة باستخدام بروتوكول SFTP.
2. التحقّق من صحة الملف: يتحقّق النظام من صحة الملف وفك ضغطه وتنسيق المخطط العام.
3. استخراج البيانات والتحقّق من صحتها: تعمل سلسلة المعالجة على تحليل السجلات المحلية الفردية (poi_id والعنوان والإحداثيات وعمليات الترجمة) والتحقّق من صحة البنية واكتمال البيانات والامتثال للسياسات.
4. التسوية والمطابقة: يتم تمرير الكيانات الصالحة إلى محرّك المطابقة من Google للربط بمعرّفات الأماكن الأساسية من Google بغرض العرض.
5. إنشاء التقارير: يتم نشر المقاييس الموجزة وبيانات التشخيص المجمّعة للمشاكل في "عارض الاستيعاب".

التنقّل في "عارض الاستيعاب"

للاطّلاع على سجلّ عمليات عرض الخلاصة، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى مركز الإجراءات.
2. افتح صفحة "الاستيعاب" > "السجلّ".
3. فلترة جدول الاستيعاب وترتيبه وعرضه باستخدام عناصر التحكّم في الأعمدة

أعمدة قائمة النقل

يوفّر جدول الملخّص الرئيسي الأعمدة التالية لكل عملية استيعاب:

العمود	نوع البيانات	الوصف
المعرّف	String	معرّف فريد لعملية الاستيعاب.
وقت الاستيعاب (بالتوقيت العالمي المتفق عليه)	Timestamp	تاريخ ووقت (بالتوقيت العالمي المتفق عليه) بدء Google في معالجة عملية استيعاب الخلاصة
نوع العرض	Enum	نوع عملية جمع البيانات (مثل Feed)
الاسم	String	اسم لنوع استيعاب الخلاصة. سيكون هذا الإجراء google.local_vss.
الحالة	State	حالة المعالجة الإجمالية لعملية الاستيعاب (مثلاً، تمّت أو تعذّر إتمامها). اطّلِع على تعريفات الحالات.
طريقة العرض	Enum	تتم معالجة جميع خلاصات نقاط الاهتمام المحلية في وضع Batch.
الأخطاء	Integer	إجمالي عدد مشاكل التحقّق من الصحة بمستوى الخطأ التي تم رصدها.
التحذيرات	Integer	إجمالي عدد المشاكل غير الحظرية التي تم رصدها على مستوى التحذير
السلع	Integer	تمثّل هذه السمة العدد الإجمالي للمواقع المحلية التي تمت معالجتها في عملية الاستيعاب هذه.

تعريفات الحالات

يشير عمود الحالة إلى الحالة التشغيلية الحالية لعملية إرسال خلاصة:

• اكتملت العملية (STATUS_COMPLETE): تم استيعاب الخلاصة والتحقّق من صحتها ومعالجتها بنجاح بدون أخطاء فادحة.
• تعذّر (STATUS_FAILED): حدثت أخطاء في المخطط أو الملف أو المسار، ولم يتمكّن النظام من إكمال عملية الاستيعاب.
• جارٍ المعالجة (STATUS_PROCESSING): تتحقّق Google حاليًا من بيانات الخلاصة وتطابقها وتخزّنها.
• تم تخطّيه (NOT_STARTED): تم تخطّي تحميل الخلاصة (على سبيل المثال، إذا كان الطابع الزمني للإنشاء أقدم من خلاصة تمت معالجتها سابقًا).

طريقة عرض تفاصيل نقل البيانات

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

لوحات التفاصيل

تنقسم صفحة "تفاصيل الاستيعاب" إلى أربعة أقسام قابلة للتوسيع:

1. المعلومات الأساسية

تعرِض هذه السمة البيانات الوصفية الأساسية حول عملية التنفيذ:

• وقت الاستيعاب (بالتوقيت العالمي المنسّق): الطابع الزمني الذي بدأ فيه Google عملية الاستيعاب.
• نوع العرض: Feed
• الاسم: google.local_vss
• سلوك العرض: Batch
• الحالة: شارة الحالة المرمّزة بالألوان (Done وFailed وProcessing وSkipped).

2. شروط التحقق من صحة القيمة

تعرض هذه السمة جميع نتائج التحقّق التي تم رصدها أثناء عملية الاستيعاب:

• أخطاء الملف (مربع الشرح): إذا تعذّر تحميل ملف الخلاصة بالكامل (على سبيل المثال، بسبب أرشيف غير قابل للقراءة أو بنية JSON غير صالحة)، سيظهر مربع شرح بارز يتضمّن رسالة توضّح السبب الأساسي للمشكلة.
• مشاكل الكيانات (جدول قابل للتوسيع): مشاكل التحقّق من الصحة على مستوى السلعة، ويتم تجميعها حسب درجة الخطورة ورمز الخطأ.
  • رمز المشكلة: معرّف الخطأ المحدّد (مثل INVALID_ATTRIBUTE_VALUE أو MISSING_RECOMMENDED_FIELD أو SAFE_SEARCH_POLICY_VIOLATION_TEXT).
  • معلومات المشكلة: وصف تشخيصي يوضّح السبب الجذري والحقول المتأثرة.
  • السجلات: إجمالي عدد عناصر الموقع المتأثّرة بهذه المشكلة.
  • انقر على أي صف من صفوف المشاكل لتوسيع أرقام تعريف الكيانات النموذجية (poi_id) مع روابط مباشرة لفحص الخصائص في عارض المستودع الإعلاني.

3- العناصر

تقدّم بطاقات قياس أداء دلتا للمستودع على مستوى السلعة لعملية الاستيعاب:

• الإجمالي: إجمالي عدد المواقع المحلية التي تمت معالجتها.
• تمت الإضافة: عدد بطاقات بيانات الأنشطة التجارية التي تم اكتشافها حديثًا وإضافتها إلى الفهرس.
• تم التعديل: عدد الأماكن الحالية التي تم تعديل سماتها (مثل الاسم أو العنوان أو الإحداثيات أو الصور).
• تمت إزالة: عدد المواقع التي تم إسقاطها أو حذفها مقارنةً بخط الأساس السابق للخلاصة.

4. الملفات

تعرِض هذه السمة اسم ملف الخلاصة الذي تم تحميله:

• اسم الملف: اسم ملف الخلاصة (على سبيل المثال، local_feed.json.gz)

تحديد مشاكل تعذُّر البث وحلّها

عند تحديد المشاكل وحلّها في الخلاصات باستخدام "أداة عرض عملية الاستيعاب"، اتّبِع الإرشادات التالية:

المشكلة	السبب المحتمل	الإجراء المقترَح
الحالة هي Failed مع خطأ في الملف	أرشيف ZIP/GZIP تالف أو بنية JSON غير صالحة أو ترميز ملف غير متوافق	تأكَّد من أنّ خلاصتك مغلّفة بشكل صحيح باستخدام إرشادات تغليف الخلاصة.
عدد كبير من Errors عمليات التحقّق	تكون حقول المخطط المطلوبة (مثل poi_id أو location.address أو إحداثيات WGS84) غير مضمّنة في السجلات.	راجِع قائمة عمليات التحقّق الموسّعة لتحديد poi_id المخالفة، ثم صحِّح خطوط أنابيب خلاصة نقاط الاهتمام وأعِد استيراد الخلاصة.
Zero Items processed	ملف الخلاصة فارغ أو تعذّر تحليل مصفوفة JSON على مستوى الجذر.	تأكَّد من أنّ بنية غلاف الخلاصة تتوافق مع مواصفات الرسالة VssPoi. يُرجى الرجوع إلى إرشادات تغليف الخلاصة.