ตรวจสอบสถานะการเพิ่มข้อมูลตาราง
ตรวจสอบสถานะการเพิ่มข้อมูลตาราง
ใช้ 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: ถ้า ข้อมูลที่นำเข้า มีข้อมูลซ้ำกับข้อมูลใน ตารางข้อมูล เดิม จะไม่มีการนำเข้าข้อมูลใด ๆ ทั้งหมด
"fail_count"จะเท่ากับ"total_count""row"จะเป็นnull- ในกรณีนี้ ให้ตรวจสอบ
"fail_reason"เพื่อหาสาเหตุ "row_number_start"และ"row_number_end"อาจไม่ตรงกับหมายเลขแถวจริง สามารถละเว้นได้
กรณีล้มเหลวแบบที่ 2: ถ้ามีข้อขัดแย้งภายใน ข้อมูลที่นำเข้าเอง ข้อมูลแถวแรกที่ขัดแย้งจะถูกนำเข้า ส่วนแถวที่สองจะถูกตัดทิ้ง
"row"จะแสดงหมายเลขแถวของข้อมูลที่ขัดแย้งแถวที่สอง"row_number_start"และ"row_number_end"จะเป็น 0
กรณีล้มเหลวอื่น ๆ: ถ้า ข้อมูลที่นำเข้า ไม่เป็นไปตามรูปแบบหรือกฎที่กำหนด ข้อมูลแถวนั้นจะไม่ถูกนำเข้า
"row"จะแสดงหมายเลขแถวของข้อมูลที่ไม่ถูกต้อง"row_number_start"และ"row_number_end"จะเป็น 0
