GQL 상태 코드 참조

Microsoft Fabric에서 GQL 쿼리를 실행하면 결과 정보와 함께 상태 정보를 받게 됩니다. 공개 쿼리 API 상태 코드와 쿼리 엔진이 보고하는 일반적인 GQLSTATUS는 항상 같지 않습니다. 이 글에서는 두 가지 모두를 어떻게 사용하는지 설명합니다.

API 상태 코드 쿼리

쿼리 API는 기본 status.code 필드에 소수의 코드 집합을 사용합니다:

API 상태 코드	Meaning
`00000`	최소 한 행의 결과 행이 포함된 성공적인 완료.
`00001`	결과가 생략된 채 성공적으로 완료. 향후 DDL 및 DML 지원을 위해 예약되어 있습니다.
`01000`	경고 또는 정보 상태입니다. 설명과 진단 자료를 점검하세요.
`02000`	현재 행 생성 쿼리에서 결과 행은 제공되지 않습니다. 만약 결과에 가 포함되어 `nextPage`있다면 실행 중이며, 결과를 폴링할 수 있습니다.
`42000`	문법, 접근 규칙 또는 기타 사용자가 수정 가능한 쿼리 오류.
`50000`	시스템 오류나 기타 분류되지 않은 오류입니다.

광범위한 애플리케이션 제어 흐름 status.code을 위해서는 . 상태 설명은 해석하지 마세요. 텍스트가 다를 수 있으니까요.

쿼리 API는 각 상태 객체 diagnostics 레코드의 구성원 내에서 _graphaneGqlStatus 쿼리 엔진의 정식 GQLSTATUS를 보존합니다:

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

예를 들어, 수치 오버플로우와 0으로 나누기는 사용자가 수정 가능한 오류이므로 둘 다 공개 status.code로 사용됩니다42000. 진단 값은 정형적인 GQLSTATUS 22003 를 22012구별합니다.

다음 표는 일반적인 정준 GQLSTATUS 값을 나열합니다. 쿼리 엔진은 더 구체적인 조건에 대해 추가 값을 보고할 수 있습니다.

GQLSTATUS	Meaning
`00000`	최소 한 행 이상의 쿼리 완료.
`00001`	결과가 생략된 채 성공적으로 완료.
`02000`	행 생성 쿼리를 위한 데이터 없음 조건.
`01M11`	불완전한 결과. 결과는 중단되었다.
`22000`	일반 데이터 예외. 이 코드는 더 구체적인 원차 질환의 원인으로 나타날 수 있습니다.
`22003`	수치 값이 범위를 벗어났으며, 여기에는 리터럴, 연산, 집합, 캐스트에서의 오버플로우가 포함됩니다.
`22012`	0으로 나누기.
`42000`	일반적인 문법 오류 또는 접근 규칙 위반.
`G2000`	그래프 유형 위반.

기본 상태, , 에 속 additionalStatuses한 항목, 중첩된 cause 상태 각각 고유한 진단 기록과 정준 GQLSTATUS를 가집니다.

이 페이지가 도움이 되었나요?