Mensagens de erro

Esse erro é retornado quando você tenta acessar um recurso, como um conjunto de dados, tabela, visualização ou job, a que não tem acesso. Ele também é retornado quando você tenta modificar um objeto somente leitura.

Entre em contato com o proprietário do recurso e solicite acesso a ele para o usuário identificado pelo valor principalEmail no registro de auditoria do erro.

Esse erro é retornado quando há um problema com o código do usuário em que um determinado atributo de objeto é chamado, mas não existe.

Verifique se o objeto com que você está trabalhando tem o atributo que você está tentando acessar. Para mais informações sobre esse erro, consulte AttributeError.

Esse erro indica que o serviço não está disponível no momento. Isso pode acontecer devido a vários problemas temporários, incluindo:

• Aumento repentino na demanda de serviço: picos repentinos na demanda, como horários de pico de uso, podem resultar em redução de carga para proteger a qualidade do serviço para todos os usuários do BigQuery. Para evitar que o sistema fique sobrecarregado, o BigQuery pode retornar erros 500 ou 503 para uma pequena parte das solicitações.
• Problemas de rede: a natureza distribuída do BigQuery significa que os dados são transferidos com frequência entre diferentes componentes ou máquinas no sistema. Vários problemas intermitentes de conectividade de rede podem fazer com que o BigQuery retorne um erro 5xx, incluindo falhas de handshake SSL ou outros problemas de infraestrutura de rede entre o usuário eGoogle Cloud.
• Esgotamento de recursos: o BigQuery tem vários limites internos de recursos para proteger o desempenho geral do serviço contra um único usuário ou job que consuma muitos recursos. O BigQuery implementa o corte de carga para lidar com o esgotamento de recursos.
• Erros de back-end: em casos raros, um problema interno em um dos componentes do BigQuery pode resultar em um erro 500 ou 503 retornado ao cliente.

Os erros 5xx são problemas do lado do serviço, e o cliente não tem como corrigir ou controlar esses erros. Do lado do cliente, para reduzir o impacto dos erros 5xx, repita as solicitações usando esperas exponenciais truncadas. Para mais informações sobre espera exponencial, consulte Espera exponencial. No entanto, há dois casos especiais para resolver esse erro: chamadas jobs.get e jobs.insert.

jobs.get chamadas

• Se você recebeu um erro 503 ao pesquisar jobs.get, aguarde alguns segundos e tente de novo.
• Se o job for concluído, mas incluir um objeto de erro que contenha backendError, ele terá falhado. É possível repeti-lo seguramente sem se preocupar com a consistência de dados.

Chamadas jobs.insert
Se você receber esse erro ao fazer uma chamada jobs.insert, não será possível saber se o job foi concluído. Nesse caso, você precisa tentar de novo.

Se as novas tentativas não forem eficazes e os problemas persistirem, calcule a taxa de solicitações com falha e entre em contato com o suporte.
Além disso, se você observar que uma solicitação específica ao BigQuery falha persistentemente com um erro 5xx, mesmo quando repetida usando espera exponencial em várias tentativas de reinicialização do fluxo de trabalho, encaminhe o problema para o suporte para resolver o problema do lado do BigQuery, independente da taxa de erro geral calculada. Comunique claramente o impacto nos negócios para que o problema seja avaliado corretamente.

O erro 'UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported' pode ocorrer quando algumas linhas transmitidas recentemente em uma tabela não estão disponíveis para operações DML (DELETE, UPDATE,MERGE), normalmente por alguns minutos, mas em casos raros, até 90 minutos. Para mais informações, consulte Disponibilidade de dados de streaming e Limitações do DML.

Para ver se os dados estão disponíveis para operações DML de tabela, verifique a resposta tables.get para a seção streamingBuffer. Se a seção streamingBuffer estiver ausente, os dados da tabela estarão disponíveis para operações DML. Também é possível usar o campo streamingBuffer.oldestEntryTime para identificar a idade dos registros no buffer de streaming.

Este erro é retornado quando o faturamento não está ativado no projeto.

Ative o faturamento para o projeto no console doGoogle Cloud .

Esse erro é retornado quando o valor de statistics.query.billingTier de um job sob demanda excede 100. Isso ocorre quando as consultas sob demanda usam muita CPU em relação à quantidade de dados verificados. Para instruções sobre como inspecionar detalhes do job, consulte Como gerenciar jobs.

Na maioria das vezes, esse erro resulta da execução de correlações ineficientes, explícita ou implicitamente, por exemplo, devido a uma condição de junção inexata. Esses tipos de consultas não são adequados para preços sob demanda devido ao alto consumo de recursos e, em geral, podem não ser bem dimensionados. É possível otimizar a consulta ou mudar para usar o modelo de preços com base na capacidade (slots) para resolver esse erro. Para mais informações sobre como otimizar consultas, acesse Como evitar antipadrões do SQL.

Esse erro é retornado quando o BigQuery coloca temporariamente a operação que você tentou executar na lista de bloqueio, geralmente para evitar interrupção do serviço.

Entre em contato com o suporte para mais informações.

Esse erro é retornado ao tentar criar um job, um conjunto de dados ou uma tabela que já existe. O erro também é retornado quando a propriedade writeDisposition de um job é definida como WRITE_EMPTY e a tabela de destino acessada pelo job já existe.

Renomeie o recurso que você está tentando criar ou altere o valor writeDisposition no job.

Esse erro é retornado quando ocorre um erro interno no BigQuery.

Aguarde de acordo com os requisitos de retirada descritos no Contrato de nível de serviço do BigQuery, depois tente a operação novamente. Se o erro persistir, entre em contato com o suporte ou registre um bug usando o rastreador de problemas do BigQuery. Também é possível reduzir a frequência desse erro usando Reservas.

Esse erro é retornado quando há algum tipo de entrada inválida que não seja uma consulta, como campos obrigatórios ausentes ou esquema de tabela inválido. Consultas inválidas retornam um erro invalidQuery.

Este erro é retornado quando você tenta executar uma consulta inválida.

Verifique se há erros de sintaxe na sua consulta. A referência de consulta contém descrições e exemplos de como criar consultas válidas.

Esse erro é retornado quando você tenta programar uma consulta com credenciais de usuário inválidas.

Atualize as credenciais do usuário, conforme explicado em Como programar consultas.

Esse erro é retornado quando o job é criado, mas falha com um erro interno. É possível ver esse erro em jobs.query ou jobs.getQueryResults.

Tente novamente com um novo jobId. Se o erro persistir, entre em contato com o suporte.

Esse erro é retornado quando o job é criado, mas falha com um erro interno. É possível ver esse erro em jobs.query ou jobs.getQueryResults.

Tente novamente com um novo jobId. Se o erro persistir, entre em contato com o suporte.

Esse erro é retornado quando o job é criado, mas falha com um erro rateLimitExceeded. É possível ver esse erro em jobs.query ou jobs.getQueryResults.

Use a espera exponencial para reduzir a taxa de solicitação e tente novamente o job com um novo jobId.

Esse erro é retornado quando você se refere a um recurso (um conjunto de dados, uma tabela ou um job) que não existe ou quando o local na solicitação não corresponde ao local do recurso (por exemplo, o local em que um job está sendo executado). Isso também pode ocorrer ao usar decoradores de tabela para se referir a tabelas excluídas que receberam streaming recentemente.

Corrija os nomes dos recursos, especifique corretamente o local ou aguarde pelo menos 6 horas após o streaming antes de consultar uma tabela excluída.

Esse erro de job é retornado quando você tenta acessar um recurso que não foi implementado.

Entre em contato com o suporte para mais informações.

Esse erro é retornado entre o ambiente do cliente e o servidor proxy quando a solicitação não tem credenciais de autenticação válidas para o servidor proxy. Para mais informações, consulte 407 Autenticação de proxy necessária.

A solução de problemas é específica para seu ambiente. Se você receber esse erro ao trabalhar em Java, verifique se definiu as propriedades jdk.http.auth.tunneling.disabledSchemes= e jdk.http.auth.proxying.disabledSchemes= sem nenhum valor após o sinal de igual.

Esse erro é retornado quando o projeto excede uma cota do BigQuery ou uma cota personalizada, ou até mesmo quando o faturamento não foi configurado e excede o nível gratuito para consultas.

Consulte a propriedade message do objeto de erro para mais informações sobre qual cota foi excedida. Para redefinir ou aumentar uma cota do BigQuery, entre em contato com o suporte. Para modificar uma cota personalizada, envie uma solicitação na página Cotas. Se você receber esse erro usando o sandbox do BigQuery, poderá fazer upgrade do sandbox.
Para mais informações, consulte Como solucionar problemas de erros de cota do BigQuery.

Esse erro é retornado quando o projeto excede um limite de taxa de curto prazo ao enviar várias solicitações muito rapidamente. Por exemplo, consulte os limites de taxa para jobs de consulta e os limites de taxa para solicitações de API.

Reduza a taxa de solicitação.
Se você acredita que o projeto não excedeu nenhum desses limites, entre em contato com o suporte.
Para mais informações, consulte Como solucionar problemas de erros de cota do BigQuery.

Esse erro é retornado quando você tenta excluir um conjunto de dados com tabelas ou um job que esteja em execução.

Esvazie o conjunto de dados ou aguarde a conclusão do job antes de tentar excluí-lo.

Este erro é retornado quando o job usa um número excessivo de recursos.

Este erro é retornado quando o job usa um número excessivo de recursos. Para informações sobre solução de problemas, consulte Corrigir erros de recursos excedidos.

Esse erro é retornado quando os resultados da consulta são maiores do que o tamanho máximo da resposta. Algumas consultas são executadas em várias etapas, e esse erro é retornado quando qualquer etapa apresenta uma resposta muito grande, mesmo que o resultado final seja menor do que o máximo. Esse erro normalmente retorna quando consultas usam uma cláusula ORDER BY.

Adicionar uma cláusula LIMIT ou remover a cláusula ORDER BY às vezes pode ser útil. Para garantir que resultados grandes possam ser retornados, defina a propriedade allowLargeResults como true e especifique uma tabela de destino. Para mais informações, consulte Como gravar resultados de consulta extensos.

Este código de status é retornado quando um job é cancelado.

Algumas tabelas do BigQuery têm como base dados gerenciados por outras equipes de produto do Google. Esse erro indica que uma dessas tabelas está indisponível.

Ao encontrar essa mensagem de erro, é possível repetir a solicitação (consulte as sugestões de solução de problemas em internalError) ou entrar em contato com a equipe de produto do Google que lhe concedeu acesso aos dados.

O tempo limite do job expirou.

Reduza a quantidade de trabalho realizada pela sua operação para que ela seja concluída dentro do limite definido. Para mais informações, consulte Resolver erros de cota e limite.