Mensagens de erro

Neste documento, descrevemos as mensagens de erro que podem ser encontrados ao trabalhar com o BigQuery, incluindo códigos de erro HTTP e etapas de solução de problemas sugeridas.

Saiba mais sobre erros de consulta em Corrigir erros de consulta.

Para saber mais sobre erros de inserção por streaming, consulte Resolver problemas de inserções por streaming.

Tabela de erros

As respostas da API do BigQuery incluem um código do erro HTTP e um objeto de erros no corpo da resposta. Um objeto de erro geralmente é um dos seguintes:

• Um objeto errors, que contém uma matriz de objetos ErrorProto.
• Um objeto errorResults, que contém um único objeto ErrorProto.

A coluna Mensagem de erro na tabela a seguir é mapeada para a propriedade reason em um objeto ErrorProto.

Essa tabela não inclui todos os erros HTTP possíveis ou outros erros de rede. Portanto, não presuma que um erro de objeto esteja presente em todas as respostas de erro do BigQuery. Além disso, você poderá receber erros ou objetos de erro diferentes se usar as bibliotecas de cliente do Cloud para a API do BigQuery. Para mais informações, consulte Bibliotecas de cliente da API BigQuery.

Quando você recebe um código de resposta HTTP que não aparece na tabela abaixo, o código de resposta indica um problema ou um resultado esperado com a solicitação HTTP. Os códigos de resposta no intervalo 5xx indicam um erro do lado do servidor. Se você receber um código de resposta 5xx, tente fazer a solicitação novamente mais tarde. Em alguns casos, um código de resposta 5xx pode ser retornado por um servidor intermediário, como um proxy. Examine o corpo da resposta e os cabeçalhos das respostas para saber mais sobre o erro. Para conferir a lista completa de códigos de resposta HTTP, consulte códigos de resposta HTTP.

Se você usar a ferramenta de linha de comando bq para consultar o status do job, o objeto de erro não será retornado por padrão. Para visualizar o objeto de erro e a propriedade reason correspondente que é mapeada para a tabela a seguir, use a sinalização --format=prettyjson. Por exemplo, bq --format=prettyjson show -j <job id>. Para visualizar o registro detalhado da ferramenta bq, use --apilog=stdout. Para saber mais sobre como solucionar problemas da ferramenta bq, consulte Depuração.

Resposta de erro de amostra

GET https://bigquery.googleapis.com/bigquery/v2/projects/12345/datasets/foo
Response:
[404]
{
  "error": {
  "errors": [
  {
    "domain": "global",
    "reason": "notFound",
    "message": "Not Found: Dataset myproject:foo"
  }],
  "code": 404,
  "message": "Not Found: Dataset myproject:foo"
  }
}

Erros de autenticação

Os erros emitidos pelo sistema de geração de tokens OAuth retornam o seguinte objeto JSON, conforme definido pela especificação OAuth2.

{"error" : "description_string"}

O erro vem acompanhado de outro erro, seja "HTTP 400 Solicitação inválida" ou "HTTP 401 Não autorizado". description_string é um dos códigos de erro definidos pela especificação OAuth2. Por exemplo:

{"error":"invalid_client"}

Analisar erros

Use o Explorador de registros para conferir erros de autenticação de jobs, usuários ou outros escopos específicos. Confira abaixo vários exemplos de filtros do Logs Explorer que podem ser usados para analisar erros de autenticação.

Pesquise jobs com falhas e problemas de permissão nos registros de auditoria de política negada:

    resource.type="bigquery_resource"
    protoPayload.status.message=~"Access Denied"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access"
  

Pesquise um usuário ou uma conta de serviço específicos usados para autenticação:

    resource.type="bigquery_resource"
    protoPayload.authenticationInfo.principalEmail="EMAIL"
  

Substitua EMAIL pelo endereço de e-mail do usuário ou da conta de serviço.

Pesquise mudanças na política do IAM nos registros de auditoria de atividade do administrador:

    protoPayload.methodName=~"SetIamPolicy"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
  

Pesquise mudanças em um conjunto de dados específico do BigQuery nos registros de auditoria de acesso a dados:

    resource.type="bigquery_resource"
    protoPayload.resourceName="projects/PROJECT_ID/datasets/DATASET_ID"
    logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
  

Substitua:

• PROJECT_ID: o ID do projeto que contém o recurso
• DATASET_ID: o ID do projeto que contém o recurso

Mensagens de erro de conectividade

A tabela a seguir lista mensagens de erro que podem ser exibidas devido a problemas de conectividade intermitente ao usar as bibliotecas de cliente ou chamar a API BigQuery pelo código:

Mensagens de erro do console do Google Cloud

A tabela a seguir lista mensagens de erro que podem aparecer enquanto você trabalha no console do Google Cloud.