Códigos de status e código do erro HTTP para a API BigQuery

Nesta página, descrevemos os códigos de status HTTP e as mensagens de erro retornados pela API BigQuery. Use esses códigos para resolver problemas e falhas de solicitação, além de verificar o comportamento da API.

Para mais informações sobre erros que não são da API, erros de conectividade da biblioteca de cliente e erros do console do Google Cloud , consulte Mensagens de erro.

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.

Formato da resposta de erro

O BigQuery usa o formato padrão de relatório de erros HTTP para a API. As solicitações bem-sucedidas retornam códigos de status HTTP no intervalo 2xx. As solicitações com falha retornam códigos de status nos intervalos 4xx e 5xx. As solicitações que exigem um redirecionamento retornam códigos de status no intervalo 3xx. As respostas de erro geralmente incluem um documento JSON no corpo da resposta, que contém um objeto de erro com informações sobre o erro.

Nas respostas da API BigQuery, um objeto de erro geralmente é um dos seguintes:

A coluna Motivo nas tabelas de código de status nesta página é mapeada para a propriedade reason em um objeto ErrorProto. Se você usar a ferramenta de linha de comando bq para verificar o status do job, use a flag --format=prettyjson (por exemplo, bq --format=prettyjson show -j <var>JOB_ID</var>) ou --apilog=stdout para visualizar o objeto de erro e a propriedade reason dele.

A tabela a seguir descreve os elementos que podem aparecer no corpo da resposta de um erro. Os campos devem ser usados juntos para ajudar a determinar o problema. Além disso, os valores de exemplo na tabela a seguir são para fins de ilustração e não são uma lista completa de todos os valores possíveis.

Elemento Descrição
code Um valor de código de status HTTP, sem a descrição textual.

Exemplos de valores: 400 (Bad Request), 403 (Forbidden) e 404 (Not Found).
error Um contêiner para as informações de erro.
errors Um contêiner para os detalhes do erro.
erros.domain O escopo do erro. Exemplos de valores: global e usageLimits.
erros.location O item específico dentro de locationType que causou o erro. Por exemplo, se você especificar um valor inválido para um parâmetro, o location será o nome do parâmetro.

Exemplos de valores: Authorization e project.
erros.locationType O local ou a parte da solicitação que causou o erro. Use com location para identificar o erro.

Exemplos de valores incluem header e parameter.
erros.message Descrição do erro.

Exemplos de valores incluem Invalid argument, Access Denied e Not Found: Dataset myproject:foo.
erros.reason Um identificador exclusivo para a causa do erro.

Exemplos de valores incluem invalid, accessDenied e notFound.
message Descrição do erro. Igual a errors.message.

Códigos de status e código do erro HTTP

Esta seção contém alguns exemplos de códigos de status e código do erro HTTP da API BigQuery. Os códigos informativos 1xx e de sucesso 2xx são omitidos. Para mais informações, consulte os códigos de status de resposta em RFC 7231 §6, RFC 7232 §4, RFC 7233 §4, RFC 7235 §3 e RFC 6585.

400 — Solicitação inválida

Motivo Código de status HTTP Descrição Solução de problemas
badRequest 400

Uma instrução DML tenta modificar linhas que foram transmitidas recentemente com a API tabledata.insertAll legada e permanecem no buffer de streaming da tabela. O erro retorna: UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported.

Migre para a API BigQuery Storage Write (gRPC), aguarde alguns minutos para que o buffer de streaming seja limpo ou filtre a instrução para excluir as linhas transmitidas recentemente. Para mais informações, consulte Instruções DML em tabelas com um buffer de streaming.

invalid 400

A solicitação contém uma entrada inválida que não é uma consulta inválida, incluindo os seguintes casos:

  • Uma incompatibilidade de esquema (Provided Schema does not match Table table).
  • Uma coluna, um arquivo ou uma rotina RECORD que excede o limite de 15 níveis de aninhamento (Schema nested too deeply).
  • Uma tabela de destino que é excluída ou expira durante um job (Destination deleted/expired during operation).

Verifique se os esquemas fornecidos correspondem às colunas e aos modos atuais, simplifique as estruturas com mais de 15 níveis de aninhamento (ou armazene-as como JSON) e defina os tempos de validade da tabela de destino para que durem mais que os jobs em execução. Para ver as etapas por subtipo, consulte Resolver problemas de entrada inválida e erros de esquema.

invalidQuery 400

Uma consulta SQL falha nas verificações de validação ou execução por um dos seguintes motivos:

  • Sintaxe SQL, identificadores ou tipos de dados inválidos.
  • Opções de recursos não atendidas ou filtros de partição obrigatórios.
  • Os limites de saída de partição ou de aninhamento de visualização foram excedidos.
  • Um conflito de transação DML simultânea (como Concurrent conflicting update to details).

Verifique o local [line:column] para ver se há incompatibilidades de sintaxe ou tipo do GoogleSQL, satisfaça os filtros OPTIONS ou de partição necessários ou reverter as sessões paralisadas e tente novamente os jobs de DML conflitantes. Para mais informações, consulte Erros de consulta inválida e Transação cancelada devido à atualização simultânea.

jobBackendError 400

No jobs.query ou jobs.getQueryResults, um job foi criado e falhou durante a execução com um backendError. O erro retorna: The job encountered an error during execution. Retrying the job may solve the problem.

Tente novamente o job com um novo jobId usando a espera exponencial truncada, garantindo que a lógica de repetição do cliente processe as respostas HTTP 400, além dos códigos 5xx. Para mais informações, consulte Resolver problemas com os erros jobBackendError e jobInternalError.

jobInternalError 400

Em jobs.query ou jobs.getQueryResults, um job foi criado e falhou durante a execução com um erro interno. O erro retorna: The job encountered an internal error during execution and was unable to complete.

Tente novamente com um novo jobId usando a espera exponencial truncada. Para mais informações, consulte Resolver problemas com os erros jobBackendError e jobInternalError.

preconditionFailed 400

Uma condição prévia da solicitação não é atendida, incluindo os seguintes casos:

  • Uma incompatibilidade de ETag do If-Match durante uma atualização de metadados.
  • Uma chave de criptografia CMEK ausente exigida pela política da organização.
  • Um recurso que não é compatível com a edição Standard.
  • Uma gravação em um conjunto de dados de failover fora de uma reserva principal do Enterprise Plus.
  • Uma consulta de visualização materializada em uma tabela base de CDC com upserts pendentes.

Busque o recurso atual etag antes de tentar novamente, especifique a chave necessária do Cloud Key Management Service, execute a carga de trabalho em uma reserva Enterprise ou Enterprise Plus ou aguarde alguns minutos para que as upserts de CDC pendentes sejam aplicadas. Para ver as etapas por subtipo, consulte Falha na condição prévia da solicitação.

resourceInUse 400

Uma solicitação de exclusão tem como alvo um recurso que ainda está ativo ou preenchido:

  • Um conjunto de dados que ainda contém tabelas, visualizações ou rotinas.
  • Um job que ainda está pendente ou em execução.

O erro retorna: resource_type resource_id is still in use.

Esvazie o conjunto de dados antes de excluí-lo (ou defina deleteContents=true, execute bq rm -r -f -d ou DROP SCHEMA IF EXISTS dataset_name CASCADE) ou aguarde a conclusão ou o cancelamento de um job ativo antes de excluir os metadados dele. Para mais informações, consulte O recurso ainda está em uso.

resourcesExceeded 400

Um job excede os limites de recursos de execução em uma das seguintes áreas:

  • Filas de simultaneidade de DML por tabela ou limites de simultaneidade de sessão.
  • Orçamentos de memória do worker, da UDF, do embaralhamento ou do modelo de ML.
  • Partição de tabela (10.000 partições) ou limites de coluna de saída.
  • Taxas de solicitação de CMEK do Cloud Key Management Service, leituras de streaming ou transferências de dados entre regiões.
  • Limites de complexidade do plano de consulta.

O erro retorna: Resources exceeded during query execution: details.

Simplifique as consultas, agrupe as operações de DML, reduza as colunas ou partições verificadas, evite jobs simultâneos na mesma sessão ou provisione capacidade de slot dedicada para cargas de trabalho com muita mistura. Para ver as etapas por subtipo, consulte Resolver problemas de recursos excedidos e A consulta excede os recursos de memória.

storageUnusable 400

O armazenamento interno do BigQuery que contém os dados da tabela está temporariamente indisponível devido a um problema de armazenamento no serviço. O erro retorna: Storage of resource_id is unusable because reason.

Tente novamente usando a espera exponencial truncada. Para mais informações, consulte O armazenamento de tabelas está inutilizável.

streamingDataUnavailable 400

Os dados transmitidos recentemente no armazenamento otimizado para gravação ficam temporariamente indisponíveis para um job de leitura. O erro retorna: Job failed because streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Tente novamente o job com um novo jobId usando a espera exponencial truncada, garantindo que a lógica de repetição do cliente processe as respostas HTTP 400. Para mais informações, consulte Os dados de streaming estão temporariamente indisponíveis.

tableUnavailable 400

O BigQuery não pode ler uma tabela com dados que ele não gerencia, incluindo os seguintes casos:

  • A busca de um esquema de tabela do Apache Iceberg ou do Delta Lake atinge o tempo limite.
  • Uma tabela externa particionada pelo Hive não tem chaves de partição.
  • Uma tabela de apoio gerenciada pelo Google está temporariamente indisponível.

Tente buscar o esquema novamente ou use a espera exponencial truncada para resolver os tempos limite da tabela de apoio. Outra opção é verificar os caminhos de URI do Cloud Storage de key=value e recriar as tabelas externas particionadas do Hive com pelo menos uma chave de partição. Para mais informações, consulte A tabela externa ou de apoio não está disponível.

userOwnedResourceError 400

Um recurso externo de sua propriedade retorna um erro quando acessado pelo BigQuery. O erro retorna: Error when accessing a user-owned external resource_type resource resource_name. The resource provided error: external_error.

Inspecione resource_type e resource_name na mensagem de erro para identificar o recurso externo e resolver o erro subjacente informado em external_error. Para mais informações, consulte Erro de recurso externo de propriedade do usuário.

vortexDataUnavailable 400

Os dados transmitidos recentemente usando a API BigQuery Storage Write (gRPC) para o armazenamento otimizado para gravação ficam temporariamente indisponíveis para uma consulta. O erro retorna: Job failed because vortex streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Tente novamente o job de consulta com um novo jobId usando a espera exponencial truncada, garantindo que a lógica de repetição do cliente processe as respostas HTTP 400. Para mais informações, consulte Os dados de streaming estão temporariamente indisponíveis.

billingTierLimitExceeded 400

Uma consulta on demand excede o limite máximo de uso da CPU por dados verificados. O erro retorna: Query exceeded resource limits. This query used cpu_seconds_used CPU seconds but would charge only analysis_megabytes_billed M Analysis bytes... cpu_seconds_used CPU seconds were used, and this query must use less than cpu_seconds_limit CPU seconds.

Refatore o SQL para remover produtos cartesianos não intencionais, mesclagens inexatas, funções de janela não particionadas ou UDFs pesadas do JavaScript ou mude para preços baseados em capacidade (slots). Para mais informações, consulte A consulta excede os recursos de CPU e Evite padrões anti-SQL.

bytesBilledLimitExceeded 400

A estimativa de bytes de limite superior pré-execução para uma consulta excede maximumBytesBilled antes do início da execução. O erro retorna: Query exceeded limit for bytes billed: limit_bytes. required_bytes or higher required.

Visualize os bytes estimados com uma simulação, selecione apenas as colunas necessárias e filtre as colunas particionadas para reduzir o tratamento de dados ou aumente maximumBytesBilled para pelo menos required_bytes. Para mais informações, consulte A consulta excede o limite máximo de bytes faturados.

jobRateLimitExceeded 400

No jobs.query ou no jobs.getQueryResults, um job falha por um dos seguintes motivos:

  • O job excede uma limitação de taxa durante a execução (Job exceeded rate limits: Your scope exceeded quota for quota_metric...).
  • A consulta não é aceita porque a simultaneidade da fila de consultas ou o limite de slots de consulta contínua foi atingido (por exemplo, Query was not admitted as the maximum concurrency has been reached...).

Reduza os envios simultâneos (ou use a prioridade em lote ou o escalonamento automático de slots para consultas contínuas) e tente novamente o job com um novo jobId usando espera exponencial truncada. Para mais informações, consulte O job excedeu os limites de taxa e Admissão de consulta negada.

timeout 400

Uma operação excede o limite de tempo de execução, incluindo os seguintes casos:

  • Uma consulta ou simulação excede o limite de execução de seis horas.
  • Um job filho dentro de uma consulta de várias instruções expira.
  • A detecção automática do esquema da tabela externa expira.

Filtre em colunas particionadas ou em cluster e divida consultas complexas ou de várias instruções em etapas menores ou especifique um esquema explícito e URIs de origem mais restritos ao criar tabelas externas. Para mais informações, consulte A consulta excede o limite de tempo de execução e Resolver erros de cota e limite.

invalidUser 400

Uma consulta programada foi configurada com credenciais de usuário inválidas.

Atualize as credenciais do usuário para a consulta programada. Para mais informações, consulte Como programar consultas.

required 400

Uma entrada obrigatória está ausente antes da execução:

  • Um campo obrigatório em um payload ou URL de solicitação de API não foi fornecido.
  • Um objeto de configuração obrigatório em uma biblioteca de cliente está vazio ou não foi atribuído.

O erro retorna: Required parameter is missing: parameter_name.

Verifique o corpo da solicitação e os parâmetros de consulta necessários na referência da API BigQuery ou na documentação da biblioteca de cliente e inspecione o objeto de configuração antes de chamar a API. Para mais informações, consulte Parâmetro obrigatório ausente.

401 — Não autorizado

Veja a seguir um exemplo de resposta de erro que você recebe se a solicitação não tiver credenciais de autenticação válidas.

401 Unauthorized

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "unauthenticated",
        "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential."
      }
    ],
    "code": 401,
    "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.",
    "status": "UNAUTHENTICATED"
  }
}
Motivo Código de status HTTP Descrição Solução de problemas
unauthenticated 401

A autenticação da solicitação falha por um dos seguintes motivos:

  • A solicitação não tem credenciais de autenticação válidas ou usa um token de acesso do OAuth 2.0 expirado.
  • As credenciais do usuário final ou as permissões de identidade temporária de conta de serviço estão ausentes.
  • A conta de usuário do autor da chamada foi restrita ou excluída.

Atualize o OAuth ou o Application Default Credentials, conceda roles/iam.serviceAccountUser ou roles/iam.serviceAccountTokenCreator ao executar com ou personificar uma conta de serviço ou entre em contato com o administrador para restaurar uma conta restrita. Para mais informações, consulte Resolver problemas de erros não autenticados.

403 — Forbidden

Este é um exemplo de resposta de erro que você recebe se não tiver permissão para acessar o recurso solicitado.

403 Forbidden

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "accessDenied",
        "message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
      }
    ],
    "code": 403,
    "message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
  }
}
Motivo Código de status HTTP Descrição Solução de problemas
responseTooLarge 403

Uma resposta de leitura de consulta ou tabela excede os limites de tamanho de uma das seguintes maneiras:

O erro retorna: Response too large to return. details.

Especifique uma tabela de destino (e defina configuration.query.allowLargeResults como true para SQL legado), remova ORDER BY ou adicione LIMIT ou leia linhas grandes usando a API BigQuery Storage Read ou EXPORT DATA. Para mais informações, consulte A resposta da consulta é muito grande e Limite de tamanho da resposta de linha única excedido.

apiLimitExceeded 403

Uma solicitação excede um dos seguintes limites de API ou de metadados:

  • Limites de taxa de solicitação de API por minuto.
  • Cotas de avaliação de metadados de tabela ou política.
  • Limites de criação de réplicas de conjuntos de dados entre regiões (Cannot add more than limit replicas for a region within window day(s)).

O erro retorna: API limit exceeded: details.

Tente novamente as solicitações com falha com espera exponencial truncada, leituras e carregamentos em lote, simplifique as políticas de segurança granulares por tabela do IAM ou no nível da linha e aguarde a janela contínua antes de adicionar réplicas de conjunto de dados. Para mais informações, consulte Erros de limite de avaliação de metadados e taxa de API e Erros de limite de criação de réplica de conjunto de dados entre regiões.

quotaExceeded 403

Seu projeto excede uma das seguintes cotas de uso:

O erro retorna: Quota exceeded: Your scope exceeded quota for quota_metric. For more information, see https://cloud.google.com/bigquery/docs/troubleshoot-quotas.

Inspecione o erro message para identificar a cota excedida, otimize as consultas de alta verificação ou faça upgrade do sandbox ou ajuste as cotas personalizadas na página Cotas. Para mais informações, consulte Erros de cota de consulta diária personalizada.

rateLimitExceeded 403

Uma solicitação é rejeitada por um dos seguintes limites de taxa ou simultaneidade:

  • Limites de limitação de taxa de API ou de job de consulta de curto prazo (Exceeded rate limits: too many quota_metric for this scope...).
  • Simultaneidade da fila de consultas ou limites de slots de reserva de consulta contínua (por exemplo, Query was not admitted as the maximum concurrency has been reached...).

Reduza a taxa de solicitação e tente novamente usando a espera exponencial truncada ou execute consultas não urgentes com prioridade de lote e ajuste a simultaneidade de reserva ou o escalonamento automático de slots. Para mais informações, consulte Resolver erros de cota e limite e Admissão de consulta negada.

accessDenied 403

O acesso a um recurso do BigQuery é negado por um dos seguintes motivos:

  • O principal não tem as permissões do IAM necessárias no projeto, conjunto de dados ou tabela de destino.
  • Uma visualização autorizada, uma política de acesso no nível da linha ou uma tag de política no nível da coluna restringe o acesso.
  • As permissões de CMEK do Cloud Key Management Service ou da fonte de dados externa estão ausentes.

O erro retorna: Access Denied: resource_type resource_id: details.

Inspecione os Registros de auditoria do Cloud (protoPayload.authorizationInfo) e a Análise de políticas para identificar a permissão ausente e conceder o papel predefinido do BigQuery com privilégio mínimo. Para mais informações, consulte Resolver problemas comuns de acesso negado.

policyViolation 403

Um perímetro de segurança ou uma política da organização bloqueia a solicitação:

  • Um perímetro do VPC Service Controls restringe o acesso (incluindo exportações do Google Drive ou tabelas externas em projetos do VPC-SC).
  • Uma restrição da política da organização, como constraints/gcp.resourceLocations, não permite a operação.

Filtre a Análise de registros por vpcServiceControlsUniqueIdentifier e verifique o Analisador de violações, exporte ou carregue dados usando um bucket do Cloud Storage dentro do perímetro ou selecione uma região permitida pelas restrições da política da organização. Para mais informações, consulte Resolver erros de violação de política.

billingNotEnabled 403

O projeto não tem faturamento ativo para a operação solicitada:

  • O faturamento não está ativado para o projeto.
  • O projeto é executado no sandbox do BigQuery, em que tabelas, visualizações e partições expiram após 60 dias (expiration time must be less than 60 days).

O erro retorna: Billing has not been enabled for this project. Enable billing at https://console.cloud.google.com/billing. details.

Ative o faturamento do projeto no console doGoogle Cloud para fazer upgrade do sandbox do BigQuery e atualize os prazos de validade padrão das tabelas, visualizações e partições. Para mais informações, consulte O faturamento não está ativado para o projeto.

blocked 403

O BigQuery adicionou temporariamente a operação tentada a uma lista de bloqueio para evitar uma interrupção do serviço. O erro retorna: Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support.

Entre em contato com o Cloud Customer Care com o carimbo de data/hora exato, o ID do projeto e o código da tarefa do BigQuery para investigar a regra de mitigação administrativa. Para mais informações, consulte A solicitação foi bloqueada para proteger a operação do sistema.

termsOfServiceNotAccepted 403

O projeto não aceitou os Termos de Serviço do BigQuery. O erro retorna: BigQuery Terms of Service have not been accepted.

Faça login no console doGoogle Cloud , selecione seu país e marque a caixa de seleção dos Termos de Serviço na página de recepção, se solicitado, e clique em Concordar e continuar. Para mais informações, consulte Termos de Serviço do BigQuery não aceitos.

404 — Não encontrado

Veja a seguir um exemplo de resposta de erro que você recebe se tentar recuperar um conjunto de dados ou recurso que não existe.

404 Not Found

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "Not Found: Dataset myproject:foo"
      }
    ],
    "code": 404,
    "message": "Not Found: Dataset myproject:foo"
  }
}
Motivo Código de status HTTP Descrição Solução de problemas
notFound 404

Um recurso solicitado não foi encontrado por um dos seguintes motivos:

  • O conjunto de dados, a tabela ou o job de destino não existe ou expirou.
  • Um URI de arquivo externo do Cloud Storage ou do Google Drive não existe.
  • O local da solicitação não corresponde ao local do conjunto de dados ou do job.

O erro retorna: Not found: resource_type resource_id.

Verifique o identificador e o local exatos do projeto, do conjunto de dados e da tabela, que diferenciam maiúsculas de minúsculas, restaure tabelas excluídas dentro da janela de viagem no tempo, execute novamente as consultas cujas tabelas de resultados armazenadas em cache expiraram ou confirme se os arquivos externos do Cloud Storage ou do Google Drive existem. Para mais informações, consulte Tabela não encontrada, Local não encontrado e Job não encontrado.

409 — Conflito

Veja a seguir um exemplo de resposta de erro que você recebe se tentar criar um recurso que já existe.

409 Conflict

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "duplicate",
        "message": "Already Exists: Dataset myproject:mydataset"
      }
    ],
    "code": 409,
    "message": "Already Exists: Dataset myproject:mydataset"
  }
}
Motivo Código de status HTTP Descrição Solução de problemas
abortd 409

Uma operação é interrompida devido a uma modificação ou conflito simultâneo (retornado com o motivo abortd).

Tente realizar a operação novamente depois que a operação conflitante for concluída usando a espera exponencial truncada ou reverter as transações de várias instruções interrompidas antes de tentar novamente. Para mais informações, consulte A operação foi cancelada.

duplicate 409

Uma solicitação entra em conflito com um recurso atual de uma das seguintes maneiras:

  • Criar um recurso de conjunto de dados, tabela ou job que já existe.
  • Executar um job com writeDisposition definido como WRITE_EMPTY quando a tabela de destino já existe.

O erro retorna: Already Exists: resource_type resource_id.

Use um nome de recurso diferente, use IF NOT EXISTS ou CREATE OR REPLACE em instruções DDL, mude writeDisposition para WRITE_APPEND ou WRITE_TRUNCATE ou permita que o BigQuery gere um jobId aleatório. Para ver as etapas por subtipo, consulte O recurso já existe.

499 — Solicitação fechada pelo cliente

Motivo Código de status HTTP Descrição Solução de problemas
stopped 499

Um job é interrompido antes da conclusão por um dos seguintes motivos (a sondagem jobs.get retorna HTTP 200 com reason: stopped):

  • Um autor da chamada cancela explicitamente o job (User requested cancellation).
  • O job excede um tempo limite de execução ou fila configurado (Job timed out after duration ou Job timed out in the queue after duration).

O erro retorna: Job execution was cancelled: details.

Aumente as opções de tempo limite da fila de projetos ou de configuration.jobTimeoutMs (ou otimize o ambiente de execução e a simultaneidade da consulta) ou verifique os Registros de auditoria do Cloud para chamadas de jobservice.cancel. Para ver as etapas por subtipo, consulte A execução do job foi cancelada.

500 — Erro interno do servidor

Motivo Código de status HTTP Descrição Solução de problemas
internalError 500

Ocorreu um erro interno no BigQuery. O erro retorna: An internal error occurred and the request could not be completed.

Aguarde de acordo com os requisitos de espera no Contrato de nível de serviço do BigQuery e tente novamente usando a espera exponencial truncada ou use Reservas para reduzir a frequência de erros temporários. Para mais informações, consulte Resolver erros internalError.

501 — Não implementado

Motivo Código de status HTTP Descrição Solução de problemas
notImplemented 501

Uma solicitação tenta usar um recurso ou uma operação não implementada para o recurso de destino, como:

  • Copiar uma tabela com um tipo de armazenamento não gerenciado.
  • Executar uma opção ALTER SEARCH INDEX não compatível.

O erro retorna: Not Implemented: details.

Materialize origens de cópia de tabela não compatíveis usando CREATE TABLE destination_table AS SELECT * FROM source_table ou remova e recrie índices da Pesquisa com DROP SEARCH INDEX e CREATE SEARCH INDEX. Para conferir as etapas por subtipo, consulte O recurso ou a operação não foi implementado.

503 — Serviço indisponível

Motivo Código de status HTTP Descrição Solução de problemas
backendError 503

O serviço está temporariamente indisponível por um dos seguintes motivos:

  • Um aumento na demanda de serviço (redução de carga) ou esgotamento de recursos internos.
  • Problemas intermitentes de conectividade de rede.
  • Um problema temporário no componente de back-end.

O erro retorna: Error encountered during execution. Retrying may solve the problem.

Tente novamente as solicitações usando a espera exponencial truncada e tente novamente os jobs com falha com um novo jobId. Se os erros persistirem nas novas tentativas, compare sua taxa de falha de 30 dias com o SLA do BigQuery e entre em contato com o Cloud Customer Care. Consulte Resolver erros backendError.