ตรวจสอบสถานะการเพิ่มข้อมูลตาราง

ตรวจสอบสถานะการเพิ่มข้อมูลตาราง

ใช้ API นี้เพื่อตรวจสอบสถานะการประมวลผลของงานที่ใช้ในการเพิ่มข้อมูลลงในตาราง

วิธีการร้องขอ

GET

Endpoint

https://api-${endpoint}.gptbots.ai/v1/database/query/import-results

การยืนยันตัวตน

โปรดดูรายละเอียดวิธีการยืนยันตัวตนใน API Overview

การร้องขอ

ตัวอย่างการร้องขอ

curl -X GET 'https://api-${endpoint}/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \ -H 'Authorization: Bearer ${API Key}'
                      
                      curl -X GET 'https://api-${endpoint}/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \
-H 'Authorization: Bearer ${API Key}'

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

ส่วนหัวของคำร้องขอ

ฟิลด์ ประเภท คำอธิบาย
Authorization Bearer ${API Key} ใช้ Authorization: Bearer ${API Key} สำหรับการยืนยันตัวตน รับ API Key ได้จากหน้า API Key

Query Parameters

ฟิลด์ ประเภท จำเป็น คำอธิบาย
ids list ใช่ รายการรหัสงานสำหรับการเพิ่มข้อมูล

การตอบกลับ

ตัวอย่างการตอบกลับ

[ { "id": "68ec7ad3e307920f002648cd", "progress": 1, "status": "FAIL", "total_count": 4, "success_count": 0, "fail_count": 4, "fail_detail": [ { "row": null, "row_number_start": 1, "row_number_end": 2, "fail_reason": "(1062, \"Duplicate entry '14' for key 'product_feed_090833.id'\")" }, { "row": 2, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`id` ต้องไม่ซ้ำกัน แต่พบค่าซ้ำ '14' (แถวแรกอยู่ที่ row `1`)." }, { "row": 4, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`no` จำเป็นต้องมีค่าและต้องไม่ว่าง; ค่าปัจจุบันไม่ถูกต้องหรือไม่มี property นี้ `no` ต้องไม่ซ้ำกัน แต่ค่าปัจจุบันว่างหรือไม่มี property นี้" } ] } ]
                      
                      [
    {
        "id": "68ec7ad3e307920f002648cd",
        "progress": 1,
        "status": "FAIL",
        "total_count": 4,
        "success_count": 0,
        "fail_count": 4,
        "fail_detail": [
            {
                "row": null,
                "row_number_start": 1,
                "row_number_end": 2,
                "fail_reason": "(1062, \"Duplicate entry '14' for key 'product_feed_090833.id'\")"
            },
            {
                "row": 2,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`id` ต้องไม่ซ้ำกัน แต่พบค่าซ้ำ '14' (แถวแรกอยู่ที่ row `1`)."
            },
            {
                "row": 4,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`no` จำเป็นต้องมีค่าและต้องไม่ว่าง; ค่าปัจจุบันไม่ถูกต้องหรือไม่มี property นี้ `no` ต้องไม่ซ้ำกัน แต่ค่าปัจจุบันว่างหรือไม่มี property นี้"
            }
        ]
    }
]

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบกลับที่สำเร็จ

ฟิลด์ ประเภท คำอธิบาย
id string รหัสงานที่ไม่ซ้ำกัน
progress int เปอร์เซ็นต์ความคืบหน้าของงาน (1-100)
status string สถานะของงาน "FAIL" หมายถึงล้มเหลว, "PENDING_PARSE" หมายถึงกำลังแปลงไฟล์, "AVAILABLE" หมายถึงมีการเพิ่มข้อมูลสำเร็จอย่างน้อยหนึ่งรายการ
total_count int จำนวนรายการที่ประมวลผลทั้งหมด
success_count int จำนวนรายการที่ประมวลผลสำเร็จ
fail_count int จำนวนรายการที่ประมวลผลล้มเหลว
fail_detail Array<Object> ตำแหน่งและสาเหตุของการเพิ่มข้อมูลที่ล้มเหลว
row int หมายเลขแถวที่เกิดข้อผิดพลาด ถ้าเป็น null หมายถึงไม่สามารถระบุแถวได้
row_number_start int จุดเริ่มต้นของช่วงแถวที่เกิดข้อผิดพลาด (เป็นช่วงสิบแถว)
row_number_end int จุดสิ้นสุดของช่วงแถวที่เกิดข้อผิดพลาด (เป็นช่วงสิบแถว)
fail_reason string คำอธิบายสาเหตุของข้อผิดพลาด

การตอบกลับที่ล้มเหลว

ฟิลด์ ประเภท คำอธิบาย
code int รหัสข้อผิดพลาด
message string รายละเอียดข้อผิดพลาด

รหัสข้อผิดพลาด

รหัส ข้อความ
50000 ข้อผิดพลาดภายในระบบ

วิธีอ่านผลลัพธ์การตอบกลับ

  1. กรณีล้มเหลวแบบที่ 1: ถ้า ข้อมูลที่นำเข้า มีข้อมูลซ้ำกับข้อมูลใน ตารางข้อมูล เดิม จะไม่มีการนำเข้าข้อมูลใด ๆ ทั้งหมด

    • "fail_count" จะเท่ากับ "total_count"
    • "row" จะเป็น null
    • ในกรณีนี้ ให้ตรวจสอบ "fail_reason" เพื่อหาสาเหตุ
    • "row_number_start" และ "row_number_end" อาจไม่ตรงกับหมายเลขแถวจริง สามารถละเว้นได้
  2. กรณีล้มเหลวแบบที่ 2: ถ้ามีข้อขัดแย้งภายใน ข้อมูลที่นำเข้าเอง ข้อมูลแถวแรกที่ขัดแย้งจะถูกนำเข้า ส่วนแถวที่สองจะถูกตัดทิ้ง

    • "row" จะแสดงหมายเลขแถวของข้อมูลที่ขัดแย้งแถวที่สอง
    • "row_number_start" และ "row_number_end" จะเป็น 0
  3. กรณีล้มเหลวอื่น ๆ: ถ้า ข้อมูลที่นำเข้า ไม่เป็นไปตามรูปแบบหรือกฎที่กำหนด ข้อมูลแถวนั้นจะไม่ถูกนำเข้า

    • "row" จะแสดงหมายเลขแถวของข้อมูลที่ไม่ถูกต้อง
    • "row_number_start" และ "row_number_end" จะเป็น 0