Troubleshooting errors

Esta página descreve as mensagens de erro que você pode encontrar ao consultar dados com o Ads Data Hub e fornece orientações para solução de 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 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 você não encontrar o erro relevante aqui ou se 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 atribuída.	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. Depois, 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 dos 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ê visualizar a tabela. Execute novamente a consulta especificando uma tabela de saída que você tenha permissão de 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	Adicione uma conta de faturamento para o projeto no console do Google Cloud. (Saiba mais.) Caso você tenha dúvidas sobre essa tarefa, entre em contato com a equipe de suporte do BigQuery ou consulte este artigo da Central de Ajuda do BigQuery para receber mais ajuda com problemas de faturamento.
	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 obtém um grupo de usuário 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: as consultas que usam tabelas de dados próprios exigem que você atualize suas configurações de consentimento.	Esse erro é retornado quando uma consulta faz referência a tabelas de dados próprios (1PD), se você não confirmou que recebeu o consentimento do usuário.	Peça e confirme o consentimento do usuário. Remova as referências às tabelas de dados próprios.
As tabelas de serviços diferentes do Google não podem ser combinadas. Agregar cada Serviço do Google individualmente e combinar 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, seja por Limite cada consulta a um único Serviço do Google. Uso de instruções CREATE TABLE com OPTIONS(privacy_checked_export=true).