GQL durum kodları başvurusu

Microsoft Fabric'te GQL sorguları çalıştırdığınızda, durum bilgisini ve sonucu alırsınız. Açık Sorgu API durum kodu ile sorgu motoru tarafından bildirilen kanonik GQLSTATUS her zaman aynı değildir. Bu makale her ikisinin de nasıl kullanılacağını açıklıyor.

Sorgu API durum kodları

Sorgu API, ana status.code alanda küçük bir kod seti kullanır:

API durum kodu Meaning
00000 En az bir sonuç satırıyla başarılı tamamlama.
00001 Başarıyla tamamlandı, sonuç çıkarıldı. Gelecekteki DDL ve DML desteği için ayrılmıştır.
01000 Bir uyarı veya bilgilendirme durumu. Tanım ve tanı incelemesini inceleyin.
02000 Şu anda satır üreten sorgudan herhangi bir sonuç satırı mevcut değildir. Sonuçta , varsa nextPage, uygulama hâlâ devam ediyor ve sonucu almak için anket yapabilirsiniz.
42000 Bir sözdizimi, erişim kuralı veya kullanıcı tarafından düzeltilebilen başka bir sorgu hatası.
50000 Bir sistem veya başka şekilde sınıflandırılmamış bir hata.

Geniş uygulama kontrol akışı status.codeiçin . Durum açıklamasını ayrıştırmayın çünkü metni değişkenlik gösterebilir.

Kanonik sorgu motoru GQLSTATUS

Sorgu API, her durum nesnesinin diagnostics kaydının üyesindeki sorgu motorundan _graphaneGqlStatus kanonik GQLSTATUS'u korur:

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

Örneğin, sayısal taşma ve sıfıra bölme kullanıcı tarafından düzeltilebilen hatalardır, bu nedenle her ikisi 42000 de genel status.codeolarak kullanılır. Tanısal değer, kanonik GQLSTATUS'u 22003 'den 22012ayırır.

Aşağıdaki tablo, yaygın kanonik GQLSTATUS değerlerini listeler. Sorgu motoru, daha spesifik koşullar için ek değerler raporlayabilir.

GQLSTATUS Meaning
00000 En az bir satır ile başarılı bir sorgu tamamlanması.
00001 Başarıyla tamamlandı, sonuç çıkarıldı.
02000 Satır üreten sorgu için veri olmama koşunu.
01M11 Eksik sonuç. Sonuç kısaltıldı.
22000 Genel veri istisnası. Bu kod, daha spesifik bir birincil durumun nedeni olarak görünebilir.
22003 Aralık dışı sayısal değer, kelime harbi, operasyon, toplam veya döküm dahil olmak üzere taşma dahil.
22012 Sıfıra bölme.
42000 Genel sözdizimi hatası veya erişim kuralı ihlali.
G2000 Grafik tipi ihlali.

Birincil durumlar, içindeki additionalStatusesgirişler ve iç içe cause durumların her birinin kendi tanısal kaydı ve kanonik GQLSTATUS'u vardır.