Informazioni di riferimento per i codici di stato GQL

Quando esegui query GQL in Microsoft Fabric, ricevi informazioni di stato insieme al risultato. Il codice di stato pubblico dell'API di query e lo stato canonico GQL riportato dal motore di query non sono sempre gli stessi. Questo articolo spiega come usare entrambi.

Consulta i codici di stato API

L'API Query utilizza un piccolo insieme di codici nel campo principale status.code :

Codice di stato API Meaning
00000 Completamento con successo con almeno una serie di risultati.
00001 Completamento con successo con risultato omesso. Riservato per il supporto futuro DDL e DML.
01000 Un avvertimento o una condizione informativa. Ispeziona la descrizione e la diagnostica.
02000 Attualmente non sono disponibili righe di risultati da una query che produce righe. Se il risultato contiene nextPage, l'esecuzione è ancora in corso e puoi interrogare il risultato.
42000 Una sintassi, una regola di accesso o un altro errore di query correttibile dall'utente.
50000 Un errore di sistema o altro non classificato.

Per un flusso di controllo ampio dell'applicazione, usa status.code. Non analizzare la descrizione dello stato perché il suo testo può variare.

Motore di query canonico GQLSTATUS

L'API di Query preserva lo stato GQL canonico del motore di query nel _graphaneGqlStatus record di ogni oggetto diagnostics status:

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

Ad esempio, il sovrapprezzo numerico e la divisione per zero sono errori correttibili dall'utente, quindi entrambi usano 42000 come il pubblico status.code. Il valore diagnostico distingue lo stato 22003 canonico GQL da 22012.

La tabella seguente elenca i valori canonici comuni di GQLSTATUS. Il motore di query può riportare valori aggiuntivi per condizioni più specifiche.

GQLSTATUS Meaning
00000 Completamento con successo della query con almeno una riga.
00001 Completamento con successo con risultato omesso.
02000 Condizione di assenza di dati per una query che produce righe.
01M11 Risultato incompleto. Il risultato fu troncato.
22000 Eccezione generale dei dati. Questo codice può apparire come causa di una condizione primaria più specifica.
22003 Valore numerico fuori intervallo, incluso il surflow in un letterale, operazione, aggregato o cast.
22012 Divisione per zero.
42000 Errore di sintassi generale o violazione della regola di accesso.
G2000 Violazione del tipo di grafico.

Gli stati primari, le voci in additionalStatuses, e gli stati annidati cause hanno ciascuno il proprio record diagnostico e lo stato GQL canonico.

Contenuti correlati

  • Last updated on