Reference til GQL-statuskoder

Når du kører GQL-forespørgsler i Microsoft Fabric, modtager du statusinformation sammen med resultatet. Den offentlige Query API-statuskode og den kanoniske GQLSTATUS, som forespørgselsmotoren rapporterer, er ikke altid den samme. Denne artikel forklarer, hvordan man bruger begge dele.

Forespørg API-statuskoder

Query API'en bruger et lille sæt koder i det primære status.code felt:

API-statuskode Betydning
00000 Vellykket gennemførelse med mindst én resultatrække.
00001 Vellykket gennemførelse med udeladt resultat. Reserveret til fremtidig DDL- og DML-support.
01000 En advarsel eller informationsbetingelse. Undersøg beskrivelsen og diagnostikken.
02000 Der er i øjeblikket ingen resultatrækker tilgængelige fra en rækkeproducerende forespørgsel. Hvis resultatet indeholder nextPage, er udførelsen stadig i gang, og du kan polle efter resultatet.
42000 En syntaks-, adgangsregel eller anden brugerkorrigerbar forespørgselsfejl.
50000 En system- eller anden ikke-klassificeret fejl.

For bred applikationskontrolflow, brug status.code. Gennemgå ikke statusbeskrivelsen, fordi teksten kan variere.

Kanonisk forespørgselsmotor GQLSTATUS

Query API'et bevarer den kanoniske GQLSTATUS fra forespørgselsmotoren i _graphaneGqlStatus medlemmet af hvert statusobjekts diagnostics post:

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

For eksempel er numerisk overløb og division med nul brugerrettede fejl, så begge bruges 42000 som den offentlige status.code. Den diagnostiske værdi adskiller kanonisk GQLSTATUS 22003 fra 22012.

Følgende tabel viser almindelige kanoniske GQLSTATUS-værdier. Forespørgselsmotoren kan rapportere yderligere værdier for mere specifikke betingelser.

GQLSTATUS Betydning
00000 Succesfuld forespørgselsfuldførelse med mindst én række.
00001 Vellykket gennemførelse med udeladt resultat.
02000 Ingen data-betingelse for en rækkeproducerende forespørgsel.
01M11 Ufuldstændigt resultat. Resultatet blev forkortet.
22000 Generel dataundtagelse. Denne kode kan optræde som årsag til en mere specifik primær tilstand.
22003 Numerisk værdi uden for området, inklusive overløb i en literal, operation, aggregat eller kast.
22012 Division med nul.
42000 Generel syntaksfejl eller overtrædelse af adgangsregler.
G2000 Overtrædelse af graftype.

Primærstatusser, poster i additionalStatuses, og indlejrede cause statusser har hver deres egen diagnostiske post og kanoniske GQLSTATUS.

Relateret indhold

  • Sidst opdateret den