GQL-tilakoodien viite

Kun suoritat GQL-kyselyt Microsoft Fabric -ohjelmassa, saat tilatiedot tuloksen lisäksi. Julkinen kyselyrajapinnan tilakoodi ja kyselymoottorin raportoima kanoninen GQLSTATUS eivät aina ole samoja. Tässä artikkelissa selitetään, miten molempia voi käyttää.

Kysely-API-tilakoodit

Kyselyrajapinta käyttää pientä koodijoukkoa pääkentässä status.code :

API-tilakoodi Merkitys
00000 Onnistunut suoritus vähintään yhdellä tulosrivillä.
00001 Onnistunut lopputulos pois jääneellä tuloksella. Varattu tulevaa DDL- ja DML-tukea varten.
01000 Varoitus- tai informaatioehto. Tarkista kuvaus ja diagnostiikka.
02000 Riviä tuottavasta kyselystä ei tällä hetkellä ole saatavilla tulosrivejä. Jos tulos sisältää nextPage, suoritus on edelleen käynnissä ja voit kysyä tulosta.
42000 Syntaksi, käyttöoikeussääntö tai muu käyttäjän korjattava kyselyvirhe.
50000 Järjestelmän tai muuten luokittelematon virhe.

Laajaan sovellusohjausvirtaan käytetään status.code. Älä jäsennä tilakuvausta, koska sen teksti voi vaihdella.

Kanoninen kyselymoottori GQLSTATUS

Kyselyrajapinta säilyttää kanonisen GQLSTATUKSEN kyselymoottorista kunkin _graphaneGqlStatus tilaobjektin diagnostics tietueen jäsenessä:

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

Esimerkiksi numeerinen ylivuoto ja nollalla jakaminen ovat käyttäjän korjattavia virheitä, joten molemmat käyttävät 42000 julkisena status.code. Diagnostinen arvo erottaa kanonisen GQLSTATUKSEN 22003 .22012

Seuraava taulukko listaa yleiset kanoniset GQLSTATUS-arvot. Kyselymoottori voi raportoida lisäarvoja tarkemmista olosuhteista.

GQLSTATUS Merkitys
00000 Onnistunut kyselyn suorittaminen vähintään yhdellä rivillä.
00001 Onnistunut lopputulos pois jääneellä tuloksella.
02000 Ei data-ehtoa riviä tuottavalle kyselylle.
01M11 Epätäydellinen tulos. Tulos lyhennettiin lyhyesti.
22000 Yleinen tietopoikkeus. Tämä koodi voi esiintyä syynä erityisemmälle primaarisairaudelle.
22003 Numeerinen arvo vaihtelun ulkopuolella, mukaan lukien ylivuoto literaalissa, operaatiossa, aggregaatissa tai heitossa.
22012 Jako nollalla.
42000 Yleinen syntaksivirhe tai pääsysääntöjen rikkomus.
G2000 Graafityyppinen rikkomus.

Ensisijaisilla statuksilla, merkinnöillä additionalStatuses, ja sisäkkäisillä cause statuksilla on jokaisella oma diagnostinen tietueensa ja kanoninen GQLSTATUS.

Aiheeseen liittyvä sisältö

  • Viimeksi päivitetty