오류 메시지

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

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

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

오류 표

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

• ErrorProto 객체의 배열을 포함하는 errors 객체
• 단일 ErrorProto 객체를 포함하는 errorResults 객체

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

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

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

bq 명령줄 도구를 사용하여 작업 상태를 확인하는 경우, 오류 객체는 기본적으로 반환되지 않습니다. 오류 객체 및 다음 표에 매핑되는 해당 reason 속성을 보려면 --format=prettyjson 플래그를 사용합니다. 예를 들면 bq --format=prettyjson show -j <job id>입니다. bq 도구의 상세 로깅을 보려면 --apilog=stdout를 사용합니다. bq 도구 문제 해결에 대한 자세한 내용은 디버깅을 참조하세요.

샘플 오류 응답

GET https://bigquery.googleapis.com/bigquery/v2/projects/12345/datasets/foo
Response:
[404]
{
  "error": {
  "errors": [
  {
    "domain": "global",
    "reason": "notFound",
    "message": "Not Found: Dataset myproject:foo"
  }],
  "code": 404,
  "message": "Not Found: Dataset myproject:foo"
  }
}

인증 오류

OAuth 토큰 생성 시스템에서 발생하는 오류는 OAuth2 사양에 정의된 대로 다음 JSON 객체를 반환합니다.

{"error" : "description_string"}

이 오류에는 HTTP 400 Bad Request 오류 또는 HTTP 401 Unauthorized 오류가 동반됩니다. description_string은 OAuth2 사양에서 정의된 오류 코드 중 하나입니다. 예를 들면 다음과 같습니다.

{"error":"invalid_client"}

오류 검토

로그 탐색기를 사용하여 특정 작업, 사용자 또는 기타 범위의 인증 오류를 볼 수 있습니다. 다음은 인증 오류를 검토하는 데 사용할 수 있는 로그 탐색기 필터의 몇 가지 예입니다.

정책 거부 감사 로그에서 권한 문제가 있는 실패한 작업 검색:

    resource.type="bigquery_resource"
    protoPayload.status.message=~"Access Denied"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access"
  

인증에 사용된 특정 사용자 또는 서비스 계정 검색:

    resource.type="bigquery_resource"
    protoPayload.authenticationInfo.principalEmail="EMAIL"
  

EMAIL을 사용자 또는 서비스 계정의 이메일 주소로 바꿉니다.

관리자 활동 감사 로그에서 IAM 정책 변경사항 검색:

    protoPayload.methodName=~"SetIamPolicy"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
  

데이터 액세스 감사 로그에서 특정 BigQuery 데이터 세트의 변경사항 검색:

    resource.type="bigquery_resource"
    protoPayload.resourceName="projects/PROJECT_ID/datasets/DATASET_ID"
    logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
  

다음을 바꿉니다.

• PROJECT_ID: 리소스가 포함된 프로젝트의 ID
• DATASET_ID: 리소스가 포함된 프로젝트의 ID

연결 오류 메시지

다음 표에는 클라이언트 라이브러리를 사용하거나 코드에서 BigQuery API를 호출할 때 간헐적인 연결 문제로 인해 표시될 수 있는 오류 메시지 목록이 나와 있습니다.

Google Cloud 콘솔 오류 메시지

다음 표에는 Google Cloud 콘솔에서 작업하는 동안 표시될 수 있는 오류 메시지가 나열되어 있습니다.