Referenční informace ke stavových kódům GQL

Když spouštíte dotazy GQL v Microsoft Fabric, obdržíte informace o stavu spolu s výsledkem. Veřejný stavový kód Query API a kanonický GQLSTATUS hlášený dotazovacím enginem nejsou vždy stejné. Tento článek vysvětluje, jak používat obojí.

Dotaz na stavové kódy API

Query API používá malou sadu kódů v primárním status.code poli:

Stavový kód API Význam
00000 Úspěšné dokončení s alespoň jedním řádkem výsledků.
00001 Úspěšné dokončení s vynechaným výsledkem. Vyhrazeno pro budoucí podporu DDL a DML.
01000 Varovná nebo informační podmínka. Zkontrolujte popis a diagnostiku.
02000 Z dotazu vytvářejícího řádky nejsou momentálně k dispozici žádné řádky výsledků. Pokud výsledek obsahuje nextPage, vykonání je stále v procesu a můžete dotazovat výsledek.
42000 Syntax, pravidlo přístupu nebo jiná chyba dotazu opravitelná uživatelem.
50000 Systémová nebo jiná neklasifikovaná chyba.

Pro širší tok řízení aplikací použijte status.code. Nerozkládejte popis stavu, protože jeho text se může lišit.

Kanonický dotazovací engine GQLSTATUS

Query API uchovává kanonický GQLSTATUS z dotazovacího enginu v členu _graphaneGqlStatus záznamu každého stavového objektu diagnostics :

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

Například numerický přetečení a dělení nulou jsou chyby opravitelné uživatelem, takže obě používají 42000 jako veřejné status.code. Diagnostická hodnota odlišuje kanonický GQLSTATUS 22003 od 22012.

Následující tabulka uvádí běžné kanonické hodnoty GQLSTATUS. Dotazovací engine může hlásit další hodnoty pro specifičtější podmínky.

GQLSTATUS Význam
00000 Úspěšné dokončení dotazu alespoň jedním řádkem.
00001 Úspěšné dokončení s vynechaným výsledkem.
02000 Podmínka bez dat pro dotaz generující řádek.
01M11 Výsledek není úplný. Výsledek byl zkrácen.
22000 Výjimka obecných dat. Tento kód může být příčinou specifického primárního onemocnění.
22003 Číselná hodnota mimo rozsah, včetně přetečení v literálu, operaci, agregátu nebo přenášení.
22012 Dělení nulou.
42000 Obecná syntaxická chyba nebo porušení přístupových pravidel.
G2000 Porušení typu grafu.

Primární stavy, položky v additionalStatuses, a vnořené cause stavy mají každý svůj vlastní diagnostický záznam a kanonický GQLSTATUS.

Související obsah

  • Poslední aktualizace v