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 스토리지에서 데이터를 호스팅합니다.
	프로젝트에서 결제가 사용 설정되어 있지 않습니다.	Google Cloud 콘솔에서 프로젝트의 결제 계정을 사용 설정합니다. 자세히 알아보기 해당 작업에 대해 질문이 있으면 BigQuery 지원팀에 문의하거나 이 BigQuery 고객센터 도움말을 참고하여 결제 문제와 관련된 추가 지원을 받으세요.
	위의 시나리오 중 어느 것도 쿼리에 적용되지 않으면 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)와 함께 사용
설정할 수 없습니다. UPDM의 계정을 설정하는 중에 문제가 발생했습니다. 아래 버튼을 통해 지원팀에 문의해 주세요.	Google Cloud 프로젝트에서 도메인 제한 공유 (DRS)가 사용 설정된 경우 이 오류가 발생할 수 있습니다.	Google Cloud 프로젝트에서 DRS를 일시적으로 사용 중지하여 UPDM 설정을 완료합니다. 설정이 완료되면 DRS를 다시 사용 설정할 수 있습니다. 조직 정책으로 인해 DRS를 사용 중지할 수 없는 경우 Google 지원팀에 문의하여 도움을 받으세요.