Dokumentacja kodów stanu GQL

Gdy uruchamiasz zapytania GQL w Microsoft Fabric, otrzymujesz informacje o statusie wraz z wynikiem. Publiczny kod statusu API zapytania oraz kanoniczny status GQLSTATUS raportowany przez silnik zapytań nie zawsze są takie same. Ten artykuł wyjaśnia, jak używać obu tych metod.

Zapytaj kody statusu API

API Query używa niewielkiego zestawu kodów w polu głównym status.code :

Kod statusu API Meaning
00000 Pomyślne ukończenie z co najmniej jednym wierszem wyników.
00001 Pomyślne zakończenie z pominiętym wynikiem. Zarezerwowane na przyszłe wsparcie DDL i DML.
01000 Ostrzegawcze lub informacyjne warunki. Sprawdź opis i diagnostykę.
02000 Obecnie nie ma dostępnych wierszy wyników z zapytania generującego wiersze. Jeśli wynik zawiera nextPage, wykonanie nadal trwa i możesz przeprowadzić wynik.
42000 Składnia, reguła dostępu lub inny błąd zapytania możliwy do poprawy przez użytkownika.
50000 Błąd systemowy lub inny nieklasyfikowany.

Dla szerokiego przepływu sterowania aplikacją używaj status.code. Nie analizuj opisu statusu, bo jego tekst może się różnić.

Kanoniczny silnik zapytań GQLSTATUS

API zapytania zachowuje kanoniczny GQLSTATUS z silnika zapytań w członku _graphaneGqlStatus rekordu każdego obiektu diagnostics statusu:

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

Na przykład przepełnienie numeryczne i dzielenie przez zero to błędy korygowalne przez użytkownika, więc oba są używane 42000 jako publiczne status.code. Wartość diagnostyczna odróżnia kanoniczny GQLSTATUS 22003 od 22012.

Poniższa tabela przedstawia typowe kanoniczne wartości GQLSTATUS. Silnik zapytań może raportować dodatkowe wartości dla bardziej specyficznych warunków.

GQLSTATUS Meaning
00000 Pomyślne zakończenie zapytania z co najmniej jednym wierszem.
00001 Pomyślne zakończenie z pominiętym wynikiem.
02000 Warunek braku danych dla zapytania generującego wiersz.
01M11 Wynik niepełny. Efekt został skrócony.
22000 Wyjątek ogólnych danych. Ten kod może być przyczyną bardziej specyficznego schorzenia pierwotnego.
22003 Wartość numeryczna poza zakresem, w tym przepełnienie literału, operacji, agregatu lub przelewu.
22012 Dzielenie przez zero.
42000 Ogólny błąd składni lub naruszenie reguły dostępu.
G2000 Naruszenie typu grafu.

Statusy główne, wpisy w additionalStatuses, oraz statusy zagnieżdżone cause mają własny rekord diagnostyczny i kanoniczny status GQL.

Treści powiązane

  • Ostatnia aktualizacja o