REFERANSE for GQL-statuskoder

Når du kjører GQL-spørringer i Microsoft Fabric, mottar du statusinformasjon sammen med resultatet. Den offentlige statuskoden for Query API og den kanoniske GQLSTATUS rapportert av spørringsmotoren er ikke alltid den samme. Denne artikkelen forklarer hvordan man bruker begge.

Søk i API-statuskoder

Query API bruker et lite sett med koder i primærfeltet status.code :

API-statuskode Betydning
00000 Vellykket fullføring med minst én resultatrad.
00001 Vellykket fullføring med utelatt resultat. Reservert for fremtidig DDL- og DML-støtte.
01000 En advarsel eller informasjonsbetingelse. Sjekk beskrivelsen og diagnostikken.
02000 Ingen resultatrader er for øyeblikket tilgjengelige fra en radproduserende spørring. Hvis resultatet inneholder nextPage, pågår fortsatt utførelsen og du kan polle etter resultatet.
42000 En syntaks-, tilgangsregel eller annen brukerkorrigerbar spørringsfeil.
50000 En system- eller annen uklassifisert feil.

For bred applikasjonskontrollflyt, bruk status.code. Ikke analyser statusbeskrivelsen fordi teksten kan variere.

Kanonisk spørringsmotor GQLSTATUS

Query API bevarer den kanoniske GQL-statusen fra spørringsmotoren i _graphaneGqlStatus medlemmet av hvert statusobjekts diagnostics post:

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

For eksempel er numerisk overløp og divisjon med null brukerkorrigerbare feil, så begge brukes 42000 som offentlig status.code. Den diagnostiske verdien skiller kanonisk GQLSTATUS 22003 fra 22012.

Følgende tabell viser vanlige kanoniske GQLSTATUS-verdier. Spørringsmotoren kan rapportere tilleggsverdier for mer spesifikke forhold.

GQLSTATUS Betydning
00000 Vellykket spørringsfullføring med minst én rad.
00001 Vellykket fullføring med utelatt resultat.
02000 Ingen data-betingelse for en radproduserende spørring.
01M11 Ufullstendig resultat. Resultatet ble forkortet.
22000 Generell dataunntak. Denne koden kan fremstå som årsak til en mer spesifikk primær tilstand.
22003 Numerisk verdi utenfor rekkevidde, inkludert overløp i en bokstavelig operasjon, aggregat eller kast.
22012 Deling med null.
42000 Generell syntaksfeil eller brudd på adgangsregelen.
G2000 Brudd på graftype.

Primærstatuser, oppføringer i additionalStatuses, og nestede cause statuser har hver sin egen diagnostiske post og kanoniske GQL-status.

Beslektet innhold

  • Sist oppdatert