Referens för GQL-statuskoder

När du kör GQL-frågor i Microsoft Fabric får du statusinformation tillsammans med resultatet. Den publika statuskoden för Query API och den kanoniska GQLSTATUS som rapporteras av frågemotorn är inte alltid desamma. Den här artikeln förklarar hur man använder båda.

Fråga API-statuskoder

Query API använder en liten uppsättning koder i primärfältet status.code :

API-statuskod Meaning
00000 Lyckad slutförande med minst en resultatrad.
00001 Lyckad slutförande med utelämnat resultat. Reserverat för framtida DDL- och DML-stöd.
01000 En varning eller informationsvillkor. Granska beskrivningen och diagnostiken.
02000 Inga resultatrader är för närvarande tillgängliga från en radproducerande fråga. Om resultatet innehåller nextPage, pågår fortfarande exekveringen och du kan poll:a efter resultatet.
42000 Ett syntax-, åtkomstregel- eller annat användarkorrigerbart frågefel.
50000 Ett systemfel eller annat oklassificerat fel.

För ett brett applikationskontrollflöde, använd status.code. Tolka inte statusbeskrivningen eftersom texten kan variera.

Kanonisk frågemotor GQLSTATUS

Query API bevarar den kanoniska GQL-statusen från frågemotorn i _graphaneGqlStatus medlemmen i varje statusobjekts diagnostics post:

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

Till exempel är numeriskt överflöd och division med noll användarkorrigerbara fel, så båda använder 42000 som publik status.code. Det diagnostiska värdet skiljer kanonisk GQLSTATUS 22003 från 22012.

Följande tabell listar vanliga kanoniska GQLSTATUS-värden. Frågemotorn kan rapportera ytterligare värden för mer specifika villkor.

GQLSTATUS Meaning
00000 Lyckad förfrågan med minst en rad.
00001 Lyckad slutförande med utelämnat resultat.
02000 Inget data-villkor för en radproducerande fråga.
01M11 Ofullständigt resultat. Resultatet blev förkortat.
22000 Allmänt undantag för data. Denna kod kan förekomma som orsak till ett mer specifikt primärt tillstånd.
22003 Numeriskt värde utanför intervallet, inklusive överflöd i en bokstavlig, operation, aggregat eller cast.
22012 Delning med noll.
42000 Allmänt syntaxfel eller brott mot access-regeln.
G2000 Brott mot graftyp.

Primära statusar, poster i additionalStatuses, och nästlade cause statusar har alla sin egen diagnostiska post och kanoniska GQLSTATUS.

Relaterat innehåll

  • Last updated on