오류 메시지

이 문서는 BigQuery로 작업할 때 발생할 수 있는 오류 메시지에 대해 설명하며 HTTP 오류 코드 및 권장되는 문제 해결 단계를 포함하고 있습니다.

쿼리 오류에 대한 자세한 내용은 쿼리 오류 문제 해결을 참고하세요.

스트리밍 삽입 오류에 대한 자세한 내용은 스트리밍 삽입 문제 해결을 참고하세요.

오류 표

BigQuery API의 응답에는 HTTP 오류 코드 및 응답 본문의 오류 객체가 포함됩니다. 오류 객체는 일반적으로 다음 중 하나입니다.

다음 표의 오류 메시지 열은 ErrorProto 객체의 reason 속성에 매핑됩니다.

이 표에는 모든 가능한 HTTP 오류 또는 다른 네트워킹 오류가 포함되지 않습니다. 따라서 오류 객체가 BigQuery의 모든 오류 응답에 포함된다고 추정해서는 안 됩니다. 또한 BigQuery API에 Cloud 클라이언트 라이브러리를 사용하는 경우 다른 오류 또는 오류 객체가 수신될 수 있습니다. 자세한 내용은 BigQuery API 클라이언트 라이브러리를 참조하세요.

다음 표에 없는 HTTP 응답 코드를 받는 경우, 해당 응답 코드는 문제 또는 HTTP 요청의 예상 결과를 나타냅니다. 5xx 범위의 응답 코드는 서버 측 오류를 나타냅니다. 5xx 응답 코드를 수신하면 나중에 요청을 다시 시도하세요. 경우에 따라 프록시와 같은 중간 서버에서 5xx 응답 코드를 반환할 수 있습니다. 오류에 대한 자세한 내용은 응답 본문과 응답 헤더를 검토하세요. 전체 HTTP 응답 코드 목록은 HTTP 응답 코드를 참조하세요.

bq 명령줄 도구를 사용하여 작업 상태를 확인하는 경우, 오류 객체는 기본적으로 반환되지 않습니다. 오류 객체 및 다음 표에 매핑되는 해당 reason 속성을 보려면 --format=prettyjson 플래그를 사용합니다. 예를 들면