Troubleshooting errors

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

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

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

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

오류 메시지 설명 문제 해결
쿼리 실행 중 리소스 초과: 할당된 메모리에서 쿼리를 실행할 수 없습니다. 이 오류는 쿼리를 실행하기 위해 너무 많은 메모리가 필요할 때 반환됩니다.
  • 재집계 방지
  • 더 짧은 데이터 기간을 사용합니다.
  • 쿼리를 여러 개의 더 작은 쿼리로 나눕니다. 그런 다음 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 테이블을 사용하는 쿼리의 경우 동의 설정을 업데이트해야 합니다. 사용자 동의를 얻었음을 확인하지 않은 경우, 쿼리에서 퍼스트 파티(1PD) 테이블을 참조할 때 이 오류가 반환됩니다.
  • 사용자 동의를 얻고 확인합니다.
  • 퍼스트 파티 데이터 테이블에 대한 참조를 삭제합니다.
분리된 Google 서비스의 테이블을 결합해서는 안 됩니다. 각 Google 서비스를 개별적으로 집계하고 후 결합합니다. 이 오류는 쿼리에서, 예를 들어 정책에 따라 격리된 테이블의 허용되지 않는 조합을 사용하는 것과 같이, 서로 다른 Google 서비스의 데이터를 결합할 때 반환됩니다. 다음과 같은 방법으로 각 Google 서비스를 단일 결과로 구분합니다
  • 각 쿼리를 단일 Google 서비스로 제한
  • CREATE TABLE 문을 OPTIONS(privacy_checked_export=true)와 함께 사용