ผู้ดูการนำเข้า

ผู้ดูการนำเข้า (เข้าถึงได้ที่การนำเข้า > ประวัติใน Actions Center) จะให้การมองเห็นสถานะ ความสมบูรณ์ของการตรวจสอบ และประวัติการประมวลผลของฟีดจุดที่น่าสนใจในพื้นที่แบบเกือบเรียลไทม์แบบเกือบเรียลไทม์

ใช้เครื่องมือดูการส่งผ่านข้อมูลเพื่อติดตามการอัปโหลดฟีดรายวัน ตรวจสอบสถานะการส่งผ่านข้อมูล ตรวจสอบสถิติข้อผิดพลาดในการตรวจสอบระดับสินค้า และยืนยันการมาถึงของไฟล์ฟีด

ภาพรวม

หน้าโปรแกรมดูการส่งผ่านข้อมูลหลักจะแสดงบันทึกตามลำดับเวลาแบบย้อนกลับของฟีดทั้งหมด ที่ Google ได้รับ

ระยะของวงจรการนำเข้า

การส่งฟีดแต่ละรายการจะผ่านขั้นตอนการประมวลผลตามลำดับต่อไปนี้

  1. การรับไฟล์: Google จะรับไฟล์ฟีดโดยใช้ SFTP
  2. การตรวจสอบไฟล์: ระบบจะยืนยันความสมบูรณ์ของไฟล์ การคลายการบีบอัด และ รูปแบบสคีมาโดยรวม
  3. การแยกและการตรวจสอบความถูกต้องของเอนทิตี: ไปป์ไลน์จะแยกวิเคราะห์ระเบียนแต่ละรายการในเครื่อง (poi_id, ที่อยู่, พิกัด, การแปล) และตรวจสอบไวยากรณ์ ความสมบูรณ์ และการปฏิบัติตามนโยบาย
  4. การกระทบยอดและการจับคู่: เอนทิตีที่ถูกต้องจะส่งไปยังเครื่องมือจับคู่ของ Google เพื่อลิงก์กับรหัสสถานที่ของ Google ที่เป็น Canonical สำหรับการแสดง
  5. การสร้างรายงาน: เมตริกสรุปและการวินิจฉัยปัญหาที่จัดกลุ่มจะ เผยแพร่ไปยังผู้ดูการส่งผ่านข้อมูล

หากต้องการดูประวัติการนำเข้าฟีด ให้ทำตามขั้นตอนต่อไปนี้

  1. ลงชื่อเข้าใช้Actions Center
  2. เปิดหน้าการส่งผ่านข้อมูล > ประวัติ
  3. กรอง จัดเรียง และดูตารางการส่งผ่านข้อมูลโดยใช้ตัวควบคุมคอลัมน์

คอลัมน์รายการการส่งผ่านข้อมูล

ตารางสรุปหลักจะมีคอลัมน์ต่อไปนี้สําหรับการเรียกใช้การส่งผ่านข้อมูลแต่ละครั้ง

คอลัมน์ ประเภทข้อมูล คำอธิบาย
รหัส String ตัวระบุที่ไม่ซ้ำกันสำหรับ การเรียกใช้การส่งผ่านข้อมูล
เวลาที่ส่งผ่านข้อมูล (UTC) Timestamp วันที่และเวลา (ใน UTC) ที่ Google เริ่มประมวลผลการ ส่งฟีด
ประเภทการส่งผ่านข้อมูล Enum ประเภทการได้มาซึ่งข้อมูล (เช่น Feed)
ชื่อ String ชื่อประเภทฟีด การส่งผ่านข้อมูล ซึ่งจะเป็น google.local_vss
สถานะ State สถานะการประมวลผลโดยรวมของการ ส่งผ่านข้อมูล (เช่น เสร็จสิ้น ล้มเหลว) ดูคำจำกัดความของสถานะ
ลักษณะการทำงานของการส่งผ่านข้อมูล Enum ระบบจะประมวลผลฟีดจุดที่น่าสนใจในพื้นที่ทั้งหมดในโหมด Batch
ข้อผิดพลาด Integer จำนวนปัญหาการตรวจสอบระดับข้อผิดพลาดที่บล็อกทั้งหมด ที่ตรวจพบ
คำเตือน Integer จำนวนรวมของปัญหาที่ระดับคำเตือนซึ่งไม่บล็อก
รายการ Integer จำนวนพร็อพเพอร์ตี้ในพื้นที่ทั้งหมด ที่ประมวลผลในการนำเข้าข้อมูลนี้

คำจำกัดความสถานะ

คอลัมน์สถานะจะระบุสถานะการทำงานปัจจุบันของการส่งฟีด

  • เสร็จสิ้น (STATUS_COMPLETE): ระบบส่งผ่านข้อมูล ตรวจสอบ และประมวลผลฟีดเรียบร้อยแล้วโดยไม่มีข้อผิดพลาดร้ายแรง
  • ไม่สำเร็จ (STATUS_FAILED): การนำเข้าพบสคีมา ไฟล์ ที่เสียหาย หรือข้อผิดพลาดของไปป์ไลน์ร้ายแรง และดำเนินการไม่สำเร็จ
  • กำลังประมวลผล (STATUS_PROCESSING): Google กำลังตรวจสอบ จับคู่ และจัดเก็บข้อมูลฟีด
  • ข้าม (NOT_STARTED): ระบบข้ามการอัปโหลดฟีด (เช่น หากการประทับเวลาการสร้างเก่ากว่าฟีดที่ประมวลผลก่อนหน้านี้)

มุมมองรายละเอียดการส่งผ่านข้อมูล

คลิกแถวใดก็ได้ในตาราง Ingestion Viewer เพื่อเปิดรายละเอียดการส่งผ่านข้อมูล มุมมอง มุมมองนี้มีการ์ดการวินิจฉัยและแผงการขยายที่ครอบคลุม สำหรับการแก้ไขข้อบกพร่อง

แผงรายละเอียด

หน้ารายละเอียดการส่งผ่านข้อมูลจะแบ่งออกเป็น 4 ส่วนที่ขยายได้ ดังนี้

1. ข้อมูลพื้นฐาน

แสดงข้อมูลเมตาหลักเกี่ยวกับการเรียกใช้การดำเนินการ

  • เวลาที่ส่งผ่านข้อมูล (UTC): การประทับเวลาเมื่อ 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 ที่ละเมิด แก้ไขไปป์ไลน์ฟีด POI และนำเข้าฟีดอีกครั้ง
ไม่มี Items ดำเนินการแล้ว ไฟล์ฟีดว่างเปล่า หรือบันทึกไม่สำเร็จ การแยกวิเคราะห์อาร์เรย์ JSON ระดับรูท ตรวจสอบว่าโครงสร้าง Wrapper ของฟีดเป็นไปตามVssPoiข้อกำหนดของข้อความ โปรดดูหลักเกณฑ์ การจัดแพ็กเกจฟีด