การอ้างอิงรหัสสถานะ GQL

เมื่อคุณรันคําสั่ง GQL ใน Microsoft Fabric คุณจะได้รับข้อมูลสถานะพร้อมกับผลลัพธ์ รหัสสถานะ Query API สาธารณะและ GQLSTATUS มาตรฐานที่รายงานโดยเครื่องมือค้นหาไม่ได้เหมือนกันเสมอไป บทความนี้อธิบายวิธีใช้ทั้งสองแบบ

รหัสสถานะ API สําหรับการค้นหา

Query API ใช้ชุดโค้ดขนาดเล็กในฟิลด์หลัก status.code :

รหัสสถานะ API ความหมาย
00000 การเติมเต็มผลลัพธ์สําเร็จโดยมีอย่างน้อยหนึ่งแถวผลลัพธ์
00001 การสําเร็จงานโดยตัดผลลัพธ์ออก สงวนไว้สําหรับการรองรับ DDL และ DML ในอนาคต
01000 เป็นคําเตือนหรือเงื่อนไขข้อมูล ตรวจสอบคําอธิบายและการวินิจฉัย
02000 ขณะนี้ไม่มีแถวผลลัพธ์จากคําสั่งที่สร้างแถว หากผลลัพธ์มี nextPage, การดําเนินการยังคงดําเนินอยู่ และคุณสามารถตรวจสอบผลลัพธ์ได้
42000 ข้อผิดพลาดไวยากรณ์ กฎการเข้าถึง หรือข้อผิดพลาดอื่น ๆ ที่ผู้ใช้สามารถแก้ไขได้
50000 เป็นข้อผิดพลาดของระบบหรือข้อผิดพลาดที่ไม่ได้จัดประเภท

สําหรับการควบคุมการใช้งานที่กว้าง ให้ใช้ status.code. อย่าวิเคราะห์คําอธิบายสถานะเพราะข้อความอาจแตกต่างกัน

GQLSTATUS เครื่องมือค้นหาแบบมาตรฐาน

Query API จะเก็บรักษา GQLSTATUS แบบมาตรฐานจากเครื่องมือค้นหาใน _graphaneGqlStatus สมาชิกของแต่ละ diagnostics status object record:

"_graphaneGqlStatus": {
  "gqlType": "STRING",
  "value": "22012"
}

ตัวอย่างเช่น การล้นตัวเลขและการหารด้วยศูนย์เป็นข้อผิดพลาดที่ผู้ใช้สามารถแก้ไขได้ ดังนั้นทั้งสองจึงใช้ 42000 เป็น public status.code. ค่าวินิจฉัยนี้แยกแยะสถานะ GQL 22003 แบบมาตรฐานออกจาก 22012.

ตารางต่อไปนี้แสดงค่ามาตรฐานทั่วไปของ GQLSTATUS เครื่องมือค้นหาสามารถรายงานค่าเพิ่มเติมสําหรับเงื่อนไขที่เฉพาะเจาะจงมากขึ้น

GQLSTATUS ความหมาย
00000 การเติมคําสั่งค้นหาสําเร็จอย่างน้อยหนึ่งแถว
00001 การสําเร็จงานโดยตัดผลลัพธ์ออก
02000 เงื่อนไขไม่มีข้อมูลสําหรับคําสั่งที่สร้างแถว
01M11 ผลลัพธ์ยังไม่สมบูรณ์ ผลลัพธ์ถูกตัดทอน
22000 ข้อยกเว้นข้อมูลทั่วไป รหัสนี้อาจปรากฏเป็นสาเหตุของภาวะหลักที่เฉพาะเจาะจงมากขึ้น
22003 ค่าตัวเลขที่อยู่นอกช่วง รวมถึงการล้นในฟังก์ชัน literal, operation, aggregate หรือ cast
22012 การหารด้วยศูนย์
42000 ข้อผิดพลาดทางไวยากรณ์ทั่วไปหรือการละเมิดกฎการเข้าถึง
G2000 การละเมิดประเภทกราฟ

สถานะหลัก, รายการใน additionalStatuses, และสถานะซ้อน cause แต่ละรายการมีระเบียนวินิจฉัยและสถานะ GQL แบบมาตรฐานของตนเอง

เนื้อหาที่เกี่ยวข้อง

  • อัปเดตล่าสุดเมื่อ