Troubleshooting errors

이 페이지에서는 Ads Data Hub를 사용하여 데이터를 쿼리할 때 발생할 수 있는 오류 메시지를 설명하고 문제 해결 가이드를 제공합니다.

오류 메시지는 다음 위치에서 찾을 수 있습니다.

  • Ads Data Hub UI에서 쿼리를 수정하는 동안 쿼리 텍스트 위의 유효성 검사 상자에 오류 메시지가 표시됩니다. 유효성 검사 표시를 클릭하여 오류 텍스트를 펼칠 수 있습니다.
  • 쿼리를 실행했으나 완료되지 못한 경우 작업과 관련된 세부정보 필드의 오류 필드에 오류 메시지가 포함됩니다. Ads Data Hub UI에서 작업을 클릭하여 최근 작업 목록을 확인할 수 있습니다.
  • Ads Data Hub API와 operations 리소스를 사용하여 오류 메시지를 가져올 수 있습니다.

이 표에 가능한 모든 오류 메시지가 포함되어 있지는 않습니다. 여기에 관련 오류가 표시되지 않거나 제안된 단계로 문제가 해결되지 않으면 지원팀에 문의하세요.

오류 메시지 설명 문제 해결
쿼리 실행 중에 리소스 초과: 할당된 메모리에서 쿼리를 실행할 수 없습니다. 이 오류는 쿼리를 실행하는 데 너무 많은 메모리가 필요할 때 반환됩니다.
  • 재집계 방지
  • 더 짧은 데이터 기간을 사용합니다.
  • 쿼리를 여러 개의 더 작은 쿼리로 나눕니다. 그런 다음 BigQuery에서 출력을 결합합니다. 또는 임시 테이블을 사용하여 쿼리를 분할해보세요.
  • 더 큰 테이블이 JOIN의 왼쪽에 위치하도록 합니다.
  • Ads Data Hub의 권장사항을 검토하세요.
  • BigQuery 오류 메시지 도움말의 추가 문제 해결 방법을 검토하세요.
BigQuery 오류입니다.

오류 코드: 내부

 이 오류는 다양한 이유로 반환됩니다. 오류의 일반적인 원인은 다음과 같습니다.
  • 일시적인 문제 또는 시간 초과
  • 쿼리를 다시 실행해 봅니다.
  • OFFSET() 또는 ORDINAL() 사용 시 색인이 범위를 벗어난 경우
  • OFFSET() 또는 ORDINAL()를 삭제하거나, 대신 SAFE_OFFSET() 또는 SAFE_ORDINAL()를 사용하여 다시 작성합니다. ( 참조)
  • 재집계로 인해 데이터 오버플로가 발생한 경우.
  • 쿼리에서 재집계를 피합니다.
  • 집계되지 않은 데이터를 집계된 데이터에 조인한 다음 다시 집계하지 않습니다.
  • 결과에 NULL 요소가 포함된 배열이 있는 경우
  • 배열의 NULL 요소에 관한 BigQuery 규칙을 검토합니다.
위 시나리오 중 어느 것도 쿼리에 적용되지 않으면 Ads Data Hub 지원팀에 문의하여 오류를 진단하세요.
찾을 수 없음: <myproject:mydataset> 데이터 세트를 <regioncode> 위치에서 찾을 수 없습니다. 이 오류는 쿼리 결과를 Ads Data Hub 인스턴스와 동일한 리전에 있지 않은 BigQuery 데이터 세트에 출력하려고 할 때 반환됩니다.
  • Ads Data Hub 인스턴스와 동일한 리전에 있는 데이터 세트를 가리키는 작업을 다시 실행합니다.
  • Ads Data Hub 인스턴스와 동일한 리전에 있는 데이터 세트의 데이터를 복사하거나 다시 만듭니다.
  • 미국 또는 EU의 Ads Data Hub 인스턴스의 경우 멀티 리전 위치 US 또는 EU를 지정합니다. us-east1 또는 europe-west1과 같은 특정 리전을 지정하면 작업이 실패합니다.
Ads Data Hub 지원팀은 사용자의 Ads Data Hub 인스턴스에 할당된 리전을 수정하거나 변경할 수 없습니다.
BigQuery에서 테이블에 액세스할 수 없습니다. 이 오류는 BigQuery의 출력 테이블에 액세스할 수 없는 경우 결과 미리보기 중에 반환됩니다.
  • BigQuery의 적절한 사용자 인증 정보를 가진 조직 내 다른 사람에게 테이블 보기 권한을 요청하세요.
  • BigQuery에서 볼 수 있는 권한이 있는 출력 테이블을 지정하여 쿼리를 다시 실행합니다.
쿼리가 Ads Data Hub 개인 정보 보호 검사를 통과하지 못했습니다. 쿼리가 집계 요구사항 및 데이터 차이 검사 기준을 충족하는지 확인하세요.

오류 코드: 0400

이 오류는 다음과 같은 경우 반환됩니다.

쿼리 결과가 충분히 집계되지 않거나 이전 결과와 너무 유사한 경우

  • 각 결과 행이 필요한 최소 사용자 수 (대부분의 경우 50명, 클릭수와 전환수만 액세스할 수 있는 경우 10명)를 충족하는지 확인합니다.
  • 쿼리를 테스트할 때 샌드박스 데이터를 사용합니다.
  • Ads Data Hub의 권장사항을 검토하세요.
시스템 오류가 발생했습니다. 지원팀에 문의하세요.

오류 코드: 내부

이 오류는 다양한 이유로 반환됩니다. 오류의 일반적인 원인은 다음과 같습니다.
  • Ads Data Hub 인스턴스와 동일한 리전에 있지 않은 퍼스트 파티 테이블을 쿼리
  • 퍼스트 파티 데이터를 Ads Data Hub 인스턴스와 동일한 리전에 있는 데이터 세트에 복사합니다.
  • 타임스탬프 오버플로
  • TIMESTAMP_MICROS()를 사용하여 시간 필드 (예: query_id.time_usec)를 마이크로초에서 타임스탬프로 변환합니다.
  • Google Drive 스토리지에서 호스팅되는 데이터 쿼리
  • Google Cloud 스토리지에서 데이터를 호스팅합니다.
  • 프로젝트에서 결제가 사용 설정되어 있지 않습니다.
위 시나리오 중 어느 것도 쿼리에 적용되지 않으면 Ads Data Hub 지원팀에 문의하여 오류를 진단하세요.
쿼리에 100, 000개 한도()를 초과하는 <number>개의 사용자 세트가 포함되어 있습니다. 이 오류는 쿼리 결과에 한도 100,000개보다 많은 사용자 세트가 포함된 경우 반환됩니다. 사용자 세트는 Ads Data Hub에서 가장 기본적인 보호 단위입니다. 쿼리는 사용자 수준 Ads Data Hub 테이블에서 데이터를 가져올 때마다 사용자 세트 하나를 가져옵니다.
  • 쿼리의 복잡성을 줄입니다.
  • 쿼리에서 JOIN 수를 줄입니다(특히 사용자 수준 Ads Data Hub 테이블의 경우).
  • 더 짧은 기간에 대해 쿼리해 보세요.
  • 쿼리를 여러 개의 더 작은 쿼리로 나눕니다.
알림: 퍼스트 파티 테이블을 사용하는 쿼리를 사용하려면 동의 설정을 업데이트해야 합니다. 이 오류는 쿼리가 퍼스트 파티 데이터(1PD) 테이블을 참조할 때(사용자 동의를 얻었는지 확인하지 않은 경우) 반환됩니다.
  • 사용자 동의를 받고 확인합니다.
  • 퍼스트 파티 데이터 테이블에 대한 참조를 삭제합니다.
별도의 Google 서비스의 테이블을 결합해서는 안 됩니다. 각 Google 서비스를 개별적으로 집계하고 후에 결합 이 오류는 쿼리에서 서로 다른 Google 서비스의 데이터를 결합하는 경우(예: 정책으로 격리된 테이블의 허용되지 않는 조합을 사용하는 경우) 반환됩니다. 각 Google 서비스를 다음과 같은 방법 중 하나로 단일 결과로 구분합니다.
  • 각 쿼리를 단일 Google 서비스로 제한
  • OPTIONS(privacy_checked_export=true)와 함께 CREATE TABLE 문 사용