Referensi kode status GQL

Saat Anda menjalankan kueri GQL di Microsoft Fabric, Anda akan menerima informasi status beserta hasilnya. Kode status Query API publik dan GQLSTATUS kanonik yang dilaporkan oleh mesin query tidak selalu sama. Artikel ini menjelaskan cara menggunakan keduanya.

Kueri kode status API

Query API menggunakan sekumpulan kode kecil di bidang utama status.code :

Kode status API Meaning
00000 Penyelesaian berhasil dengan setidaknya satu baris hasil.
00001 Penyelesaian berhasil dengan hasil yang hilang. Disediakan untuk dukungan DDL dan DML di masa depan.
01000 Sebuah peringatan atau kondisi informasi. Periksa deskripsi dan diagnostik.
02000 Tidak ada baris hasil yang tersedia saat ini dari kueri yang menghasilkan baris. Jika hasilnya berisi nextPage, eksekusi masih berlangsung dan Anda dapat melakukan polling untuk hasilnya.
42000 Kesalahan sintaks, aturan akses, atau query lain yang dapat diperbaiki pengguna.
50000 Kesalahan sistem atau yang tidak diklasifikasikan.

Untuk alur kontrol aplikasi yang luas, gunakan status.code. Jangan mengurai deskripsi status karena teksnya bisa berbeda-beda.

Mesin kueri kanonik GQLSTATUS

API Query mempertahankan GQLSTATUS kanonik dari mesin query di _graphaneGqlStatus anggota catatan setiap objek diagnostics status:

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

Misalnya, numerik overflow dan pembagian dengan nol adalah kesalahan yang dapat diperbaiki oleh pengguna, sehingga keduanya menggunakan 42000 sebagai publik status.code. Nilai diagnostik membedakan GQLSTATUS 22003 kanonik dari 22012.

Tabel berikut mencantumkan nilai GQLSTATUS kanonik yang umum. Mesin kueri dapat melaporkan nilai tambahan untuk kondisi yang lebih spesifik.

GQLSTATUS Meaning
00000 Penyelesaian kueri berhasil dengan setidaknya satu baris.
00001 Penyelesaian berhasil dengan hasil yang hilang.
02000 Kondisi tanpa data untuk kueri yang menghasilkan baris.
01M11 Hasil tidak lengkap. Hasilnya dipotong.
22000 Pengecualian data umum. Kode ini dapat muncul sebagai penyebab kondisi primer yang lebih spesifik.
22003 Nilai numerik di luar rentang, termasuk overflow dalam sebuah literal, operasi, agregat, atau cast.
22012 Pembagian oleh bilangan nol.
42000 Kesalahan sintaks umum atau pelanggaran aturan akses.
G2000 Pelanggaran tipe grafik.

Status utama, entri di additionalStatuses, dan status bersarang cause masing-masing memiliki catatan diagnostik dan status GQL kanonik.

Konten terkait

  • Terakhir diperbarui pada