Troubleshooting errors

Nesta página, descrevemos as mensagens de erro que você pode encontrar ao consultar dados com o Ads Data Hub e orientações para resolver problemas.

As mensagens de erro podem ser encontradas nos seguintes locais:

  • Ao editar uma consulta na interface do Ads Data Hub, as mensagens de erro aparecem na caixa de validação acima do texto da consulta. Para expandir o texto do erro, clique em Mostrar validação.
  • Quando a conclusão de uma consulta não é concluída, o campo "Detalhes" específico do job contém uma mensagem no campo "Erro". Para encontrar uma lista dos seus trabalhos recentes, clique em Jobs na interface do Ads Data Hub.
  • Recupere mensagens de erro usando a API Ads Data Hub com o recurso operations.

Esta tabela não inclui todas as mensagens de erro possíveis. Se o erro relevante não aparecer aqui ou as etapas sugeridas não resolverem o problema, entre em contato com o suporte.

Mensagem de erro Descrição Solução de problemas
Recursos excedidos durante a execução da consulta: não foi possível executar a consulta na memória alocada. Esse erro é retornado quando a consulta exige muita memória para ser executada.
  • Evite reagregação.
  • Use um período de dados mais curto.
  • Divida a consulta em várias outras menores. Em seguida, combine as saídas no BigQuery. Como alternativa, use tabelas temporárias para dividir a consulta.
  • A tabela maior precisa ficar do lado esquerdo de qualquer JOIN.
  • Analise as práticas recomendadas do Ads Data Hub.
  • Analise a solução de problemas adicional no artigo de mensagens de erro do BigQuery.
Erro do BigQuery.

Código do erro: interno

 Esse erro é retornado por vários motivos. Causas comuns desse erro:
  • Um problema temporário ou um tempo limite
  • Tente executar a consulta de novo.
  • Ao usar OFFSET() ou ORDINAL(), se o índice estiver fora do intervalo
  • Remova OFFSET() ou ORDINAL() ou grave novamente usando SAFE_OFFSET() ou SAFE_ORDINAL(). ( ref).
  • Quando há um sobrefluxo de dados causado por novas agregações.
  • Evite nova agregação na consulta.
  • Evite agrupar não agregados a agregados e agregar novamente.
  • Quando o resultado tem uma matriz que contém um elemento NULL.
  • Revise as regras do BigQuery sobre elementos NULL em matrizes.
Se nenhum desses cenários se aplicar à sua consulta, entre em contato com o suporte do Ads Data Hub para diagnosticar o erro.
Não encontrado: o conjunto de dados <myproject:mydataset> não foi encontrado no local <regioncode>. Esse erro é retornado quando você tenta gerar resultados da consulta para um conjunto de dados do BigQuery que não está na mesma região que sua instância do Ads Data Hub.
  • Execute o trabalho novamente, apontando para um conjunto de dados que esteja na mesma região que sua instância do Ads Data Hub.
  • Copie ou recrie os dados em um conjunto de dados que está na mesma região que sua instância do Ads Data Hub.
  • Para instâncias do Ads Data Hub nos EUA ou na UE, especifique o local multirregional US ou EU. Especificar uma região específica, como us-east1 ou europe-west1, causará a falha nos jobs.
O suporte do Ads Data Hub não pode modificar ou alterar a região atribuída à sua instância do Ads Data Hub.
Não é possível acessar a tabela no BigQuery. Esse erro será retornado durante a visualização dos resultados se você não tiver acesso à tabela de saída no BigQuery.
  • Peça para alguém na sua organização com as credenciais adequadas no BigQuery conceder permissão para você ver a tabela.
  • Execute novamente a consulta especificando uma tabela de saída que você tenha permissão para visualizar no BigQuery.
Sua consulta não foi aprovada nas verificações de privacidade do Ads Data Hub. A consulta precisa cumprir os requisitos de agregação e as verificações de diferenças.

Código do erro: 0400

Esse erro é retornado quando

os resultados da consulta são agregados de forma insuficiente ou são muito semelhantes aos resultados anteriores.

  • Verifique se cada linha de resultado atende à contagem mínima de usuários necessária (50 usuários na maioria dos casos e 10 usuários quando apenas cliques e conversões são acessados).
  • Use dados do sandbox ao testar consultas.
  • Analise as práticas recomendadas do Ads Data Hub.
Erro do sistema. Entre em contato com o suporte.

Código de erro: Interno

Esse erro é retornado por vários motivos. Causas comuns desse erro:
  • Consultar uma tabela própria que não está na mesma região que sua instância do Ads Data Hub
  • Copie os dados próprios para um conjunto de dados que está na mesma região que sua instância do Ads Data Hub.
  • Sobrefluxo do carimbo de data e hora
  • Use TIMESTAMP_MICROS() para converter os campos de hora (por exemplo, query_id.time_usec) de microssegundos para um carimbo de data/hora.
  • Consultar dados hospedados no armazenamento do Google Drive
  • Hospede os dados no Google Cloud Storage.
  • O faturamento não foi ativado para esse projeto
Se nenhum desses cenários se aplicar à sua consulta, entre em contato com o suporte do Ads Data Hub para diagnosticar o erro.
A consulta contém <number> grupos de usuários, que excede o limite de 100.000 Esse erro é retornado quando os resultados da consulta contêm mais do que o limite de 100.000 conjuntos de usuários. Um conjunto de usuários é a unidade mais básica de proteção no Ads Data Hub. Uma consulta recebe um conjunto de usuários toda vez que recupera dados de uma tabela do Ads Data Hub no nível do usuário.
  • Reduza a complexidade da consulta.
  • Reduza o número de JOINs na consulta, especialmente para tabelas do Ads Data Hub no nível do usuário.
  • Consulte em um período mais curto.
  • Divida a consulta em várias outras menores.
Lembrete: consultas que usam tabelas de dados próprios exigem a atualização das configurações de consentimento. Esse erro será retornado quando uma consulta fizer referência a tabelas de dados próprios, se você ainda não tiver confirmado que obteve o consentimento do usuário.
As tabelas de Serviços do Google separados não podem ser combinadas. Agregue cada Serviço do Google individualmente e combine após Esse erro é retornado quando uma consulta combina dados de diferentes Serviços do Google, como o uso de uma combinação não permitida de tabelas isoladas por políticas. Separe cada Serviço do Google em um único resultado, de uma destas formas:
  • Limite cada consulta a um único Serviço do Google.
  • Usar instruções CREATE TABLE com OPTIONS(privacy_checked_export=true).
Falha na configuração. Encontramos problemas ao configurar sua conta da UPDM. Entre em contato com o suporte pelo botão abaixo. Talvez você encontre esse erro se o Compartilhamento restrito de domínio (DRS, na sigla em inglês) estiver ativado no seu projeto do Google Cloud. Desative temporariamente o DRS no projeto do Google Cloud para concluir a configuração da UPDM. Depois de concluir a configuração, reative o DRS. Se não for possível desativá-lo devido a políticas organizacionais, entre em contato com nossa equipe de suporte para receber ajuda.