비고
이 기능은 현재 공개 미리 보기로 제공됩니다. 이 미리 보기는 서비스 수준 계약 없이 제공되며 프로덕션 워크로드에는 사용하지 않는 것이 좋습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.
Microsoft Fabric에서 GQL 쿼리를 실행하면 결과와 함께 상태 정보를 받게 됩니다. 이 참조는 Microsoft Fabric의 그래프에서 사용하는 모든 GQLSTATUS 코드를 나열합니다.
성공 코드
| GQLSTATUS | Message | Description |
|---|---|---|
| 00000 | 참고: 성공적인 완료 | 하나 이상의 행을 사용하여 쿼리가 성공적으로 실행됨 |
| 00001 | 참고: 성공적인 완료 - 생략된 결과 | 쿼리가 성공적으로 실행되었지만 테이블이 반환되지 않음(현재 사용되지 않음) |
| 02000 | 참고: 데이터 없음 | 쿼리가 성공적으로 실행되었지만 빈 테이블을 반환했습니다. |
오류 코드
| GQLSTATUS | Message | Description |
|---|---|---|
| 22000 | 오류: 데이터 예외 | 데이터 처리 중 런타임 오류 |
| 42000 | 오류: 구문 오류 또는 액세스 규칙 위반 | 쿼리 구문 오류 또는 액세스 권한 문제 |
| G2000 | 오류: 그래프 형식 위반 | 쿼리가 그래프 스키마 제약 조건을 위반합니다. |
상태 코드 이해
성공 지표: 시작 코드는 쿼리 실행이 성공했음을 0 나타냅니다. 쿼리가 데이터(02000)를 반환하지 않더라도 쿼리 실행이 성공했습니다.
상태 코드 사용: GQLSTATUS 코드를 확인하여 쿼리가 성공했는지 확인하고 애플리케이션에서 빈 결과를 적절하게 처리합니다.
관련 콘텐츠
- GQL 언어 가이드 - GQL 구문 및 사용량에 대한 전체 가이드
- GQL 빠른 참조 - 구문 빠른 참조
- 오류 처리 전략 - 강력한 쿼리에 대한 모범 사례