Naslaginformatie over GQL-statuscodes

Wanneer je GQL-queries uitvoert in Microsoft Fabric, ontvang je statusinformatie samen met het resultaat. De publieke statuscode van de Query API en de canonieke GQLSTATUS die door de query-engine wordt gerapporteerd, zijn niet altijd hetzelfde. Dit artikel legt uit hoe je beide kunt gebruiken.

Zoek API-statuscodes op

De Query API gebruikt een kleine set codes in het primaire status.code veld:

API-statuscode Meaning
00000 Succesvolle voltooiing met ten minste één resultaatrij.
00001 Succesvolle voltooiing met een weggelaten resultaat. Gereserveerd voor toekomstige DDL- en DML-ondersteuning.
01000 Een waarschuwing of informatieve voorwaarde. Bekijk de beschrijving en diagnostiek.
02000 Er zijn momenteel geen resultaatrijen beschikbaar van een rij-producerende query. Als het resultaat bevat nextPage, is de uitvoering nog steeds gaande en kun je het resultaat pollen.
42000 Een syntaxis-, toegangsregel of andere door de gebruiker corrigeerbare queryfout.
50000 Een systeemfout of anderszins een niet-geclassificeerde fout.

Voor brede applicatiecontroleflow, gebruik status.code. Ontleed de statusbeschrijving niet omdat de tekst kan variëren.

Canonieke query-engine GQLSTATUS

De Query API behoudt de canonieke GQLSTATUS van de query-engine in het _graphaneGqlStatus lid van elk statusobjectrecord diagnostics :

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

Bijvoorbeeld, numerieke overflow en deling door nul zijn door de gebruiker corrigeerbare fouten, dus beide worden gebruikt 42000 als de publieke status.code. De diagnostische waarde onderscheidt de canonieke GQLSTATUS 22003 van 22012.

De volgende tabel geeft een weergave van veelvoorkomende canonieke GQLSTATUS-waarden. De query-engine kan extra waarden rapporteren voor meer specifieke voorwaarden.

GQLSTATUS Meaning
00000 Succesvolle queryvoltooiing met ten minste één rij.
00001 Succesvolle voltooiing met een weggelaten resultaat.
02000 Geen datavoorwaarde voor een rij-producerende query.
01M11 Onvolledig resultaat. Het resultaat werd ingekort.
22000 Algemene gegevensuitzondering. Deze code kan verschijnen als oorzaak van een meer specifieke primaire aandoening.
22003 Numerieke waarde buiten bereik, inclusief overloop in een letterlijke bewerking, bewerking, aggregaat of cast.
22012 Delen door nul.
42000 Algemene syntaxisfout of overtreding van de toegangsregel.
G2000 Overtreding van het grafiektype.

Primaire statussen, vermeldingen in additionalStatuses, en geneste cause statussen hebben elk hun eigen diagnostisch record en canonieke GQLSTATUS.

Verwante inhoud

  • Laatst bijgewerkt om