Códigos de estado y error HTTP para la API de BigQuery

En esta página, se describen los códigos de estado HTTP y los mensajes de error que devuelve la API de BigQuery. Puedes usar estos códigos para solucionar problemas y resolver fallas de solicitudes, y verificar el comportamiento de la API.

Para obtener más información sobre los errores que no son de la API, los errores de conectividad de la biblioteca cliente y los errores de la consola de Cloud de Confiance , consulta Mensajes de error.

Para obtener más información sobre los errores de consulta, consulta Soluciona errores de consulta.

Para obtener más información sobre los errores de inserción de transmisión, consulta Soluciona problemas de inserción de transmisión.

Formato de respuesta de error

BigQuery usa el formato estándar de informes de errores de HTTP para su API. Las solicitudes exitosas devuelven códigos de estado HTTP en el rango 2xx. Las solicitudes con errores devuelven códigos de estado en los rangos 4xx y 5xx. Las solicitudes que requieren un redireccionamiento devuelven códigos de estado en el rango 3xx. Las respuestas de error suelen incluir un documento JSON en el cuerpo de la respuesta, que contiene un objeto de error con información sobre el error.

En las respuestas de la API de BigQuery, un objeto de error suele ser uno de los siguientes:

La columna Motivo de las tablas de códigos de estado de esta página se asigna a la propiedad reason de un objeto ErrorProto. Si usas la herramienta de línea de comandos de bq para verificar el estado del trabajo, usa la marca --format=prettyjson (por ejemplo, bq --format=prettyjson show -j <var>JOB_ID</var>) o --apilog=stdout para ver el objeto de error y su propiedad reason.

En la siguiente tabla, se describen los elementos que pueden aparecer en el cuerpo de la respuesta de un error. Los campos se deben usar juntos para ayudar a determinar el problema. Además, los valores de ejemplo de la siguiente tabla son ilustrativos y no constituyen una lista exhaustiva de todos los valores posibles.

Elemento Descripción
code Un valor de código de estado HTTP, sin la descripción textual.

Los valores de ejemplo incluyen: 400 (solicitud incorrecta), 403 (prohibido) y 404 (no encontrado).
error Es un contenedor para la información del error.
errors Es un contenedor para los detalles del error.
errores.domain Es el alcance del error. Entre los valores de ejemplo, se incluyen global y usageLimits.
errores.location Es el elemento específico dentro de locationType que causó el error. Por ejemplo, si especificas un valor no válido para un parámetro, el location será el nombre del parámetro.

Entre los valores de ejemplo, se incluyen Authorization y project.
errores.locationType Es la ubicación o parte de la solicitud que causó el error. Úsala con location para identificar el error.

Entre los valores de ejemplo, se incluyen header y parameter.
errores.message Descripción del error.

Entre los valores de ejemplo, se incluyen Invalid argument, Access Denied y Not Found: Dataset myproject:foo.
errores.reason Es un identificador único para la causa del error.

Entre los valores de ejemplo, se incluyen invalid, accessDenied y notFound.
message Es la descripción del error. Igual que errors.message.

Códigos de estado y error HTTP

En esta sección, se incluye una lista no exhaustiva de los códigos de estado y error de HTTP de la API de BigQuery. Se omiten los códigos de información 1xx y de éxito 2xx. Para obtener más información, consulta los códigos de estado de respuesta en RFC 7231 §6, RFC 7232 §4, RFC 7233 §4, RFC 7235 §3 y RFC 6585.

400: Solicitud incorrecta

Motivo Código de estado HTTP Descripción Soluciona problemas
badRequest 400

Una declaración DML intenta modificar filas que se transmitieron recientemente con la API de tabledata.insertAll heredada y permanecen en el búfer de transmisión de la tabla. El error devuelve lo siguiente: UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported.

Migra a la API de BigQuery Storage Write (gRPC), espera unos minutos para que se vacíe el búfer de transmisión o filtra tu declaración para excluir las filas transmitidas recientemente. Para obtener más información, consulta Sentencias DML en tablas con un búfer de transmisión.

invalid 400

La solicitud contiene una entrada no válida que no es una consulta no válida, incluidos los siguientes casos:

  • Una discrepancia de esquema (Provided Schema does not match Table table)
  • Una columna, un archivo o una rutina RECORD que supera el límite de 15 niveles de anidamiento (Schema nested too deeply).
  • Una tabla de destino que se borra o vence durante un trabajo (Destination deleted/expired during operation).

Asegúrate de que los esquemas proporcionados coincidan con las columnas y los modos existentes, aplana las estructuras que superen los 15 niveles de anidamiento (o almacénalas como JSON) y establece tiempos de vencimiento de la tabla de destino para que duren más que los trabajos en ejecución. Para conocer los pasos por subtipo, consulta Soluciona problemas de entrada no válida y errores de esquema.

invalidQuery 400

Una consulta en SQL falla en las verificaciones de validación o ejecución por uno de los siguientes motivos:

  • Sintaxis, identificadores o tipos de datos de SQL no válidos.
  • Opciones de funciones no satisfechas o filtros de partición obligatorios.
  • Se superaron los límites de anidamiento de vistas o de salida de particiones.
  • Un conflicto de transacción de DML simultáneo (como Concurrent conflicting update to details).

Verifica la ubicación [line:column] para detectar discrepancias de tipo o sintaxis de GoogleSQL, cumple con los filtros OPTIONS o de partición requeridos, o revierte las sesiones detenidas y vuelve a intentar los trabajos de DML en conflicto. Para obtener más información, consulta Errores de consulta no válidos y Transacción anulada debido a una actualización simultánea.

jobBackendError 400

En jobs.query o jobs.getQueryResults, se creó un trabajo y, luego, falló durante la ejecución con un backendError. El error devuelve: The job encountered an error during execution. Retrying the job may solve the problem.

Vuelve a intentar el trabajo con un jobId nuevo usando la retirada exponencial truncada, lo que garantiza que la lógica de reintento del cliente controle las respuestas HTTP 400, además de los códigos 5xx. Para obtener más información, consulta Soluciona errores de jobBackendError y jobInternalError.

jobInternalError 400

En jobs.query o jobs.getQueryResults, se creó un trabajo y, luego, falló durante la ejecución con un error interno. El error devuelve: The job encountered an internal error during execution and was unable to complete.

Vuelve a intentar el trabajo con un jobId nuevo usando la retirada exponencial truncada. Para obtener más información, consulta Soluciona errores de jobBackendError y jobInternalError.

preconditionFailed 400

No se cumple una condición previa de la solicitud, incluidos los siguientes casos:

  • Un error de coincidencia de ETag If-Match durante una actualización de metadatos.
  • Falta una clave de encriptación de CMEK que requiere la política de la organización.
  • Es una función que no se admite en la edición Standard.
  • Una escritura en un conjunto de datos de conmutación por error fuera de una reserva principal de Enterprise Plus.
  • Una consulta de vista materializada en una tabla base de CDC con actualizaciones o inserciones pendientes.

Recupera el recurso etag actual antes de volver a intentarlo, especifica la clave de Cloud Key Management Service requerida, ejecuta la carga de trabajo en una reserva de Enterprise o Enterprise Plus, o espera unos minutos para que se apliquen las operaciones upsert de CDC pendientes. Para conocer los pasos por subtipo, consulta No se cumplió la condición previa de la solicitud.

resourceInUse 400

Una solicitud de eliminación se orienta a un recurso que aún está activo o propagado:

  • Un conjunto de datos que aún contiene tablas, vistas o rutinas.
  • Un trabajo que aún está pendiente o en ejecución.

El error devuelve lo siguiente: resource_type resource_id is still in use.

Vacía el conjunto de datos antes de borrarlo (o establece deleteContents=true, ejecuta bq rm -r -f -d o ejecuta DROP SCHEMA IF EXISTS dataset_name CASCADE), o espera a que un trabajo activo finalice o cancélalo antes de borrar los metadatos del trabajo. Para obtener más información, consulta El recurso aún está en uso.

resourcesExceeded 400

Un trabajo supera los límites de recursos de ejecución en una de las siguientes áreas:

  • Colas de simultaneidad de DML por tabla o límites de simultaneidad de sesiones.
  • Presupuestos de memoria de trabajadores, UDF, de Shuffle o de modelos de AA.
  • Límites de partición de tabla (10,000 particiones) o de columnas de salida.
  • Porcentajes de solicitudes de CMEK de Cloud Key Management Service, lecturas de transmisión o transferencias de datos entre regiones.
  • Límites de complejidad del plan de consultas.

El error devuelve lo siguiente: Resources exceeded during query execution: details.

Simplifica las consultas, agrupa las operaciones de DML por lotes, reduce las columnas o particiones analizadas, evita los trabajos simultáneos en la misma sesión o aprovisiona capacidad de ranuras dedicada para las cargas de trabajo con un uso intensivo de shuffle. Para conocer los pasos por subtipo, consulta Soluciona problemas de recursos excedidos y La consulta excede los recursos de memoria.

storageUnusable 400

El almacenamiento interno de BigQuery que contiene los datos de la tabla no está disponible de forma temporal debido a un problema de almacenamiento del servicio. El error devuelve lo siguiente: Storage of resource_id is unusable because reason.

Vuelve a intentar el trabajo con la retirada exponencial truncada. Para obtener más información, consulta El almacenamiento de tablas no se puede usar.

streamingDataUnavailable 400

Los datos transmitidos recientemente en el almacenamiento optimizado para escritura no están disponibles de forma temporal para un trabajo de lectura. El error devuelve lo siguiente: Job failed because streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Vuelve a intentar el trabajo con un jobId nuevo usando la retirada exponencial truncada, lo que garantiza que la lógica de reintentos del cliente controle las respuestas HTTP 400. Para obtener más información, consulta Los datos de transmisión no están disponibles temporalmente.

tableUnavailable 400

BigQuery no puede leer una tabla cuyos datos no administra, incluidos los siguientes casos:

  • Se agota el tiempo de espera para recuperar un esquema de tabla de Apache Iceberg o Delta Lake.
  • Una tabla externa particionada con Hive no tiene claves de partición.
  • Una tabla de copia de seguridad administrada por Google no está disponible temporalmente.

Vuelve a intentar recuperar el esquema o los tiempos de espera de la tabla de copia de seguridad con la retirada exponencial truncada, o verifica las rutas de URI de Cloud Storage de key=value y vuelve a crear tablas externas particionadas de Hive con al menos una clave de partición. Para obtener más información, consulta La tabla externa o de respaldo no está disponible.

userOwnedResourceError 400

Un recurso externo de tu propiedad devuelve un error cuando BigQuery accede a él. El error devuelve lo siguiente: Error when accessing a user-owned external resource_type resource resource_name. The resource provided error: external_error.

Inspecciona resource_type y resource_name en el mensaje de error para identificar el recurso externo y resolver el error subyacente informado en external_error. Para obtener más información, consulta Error de recurso externo propiedad del usuario.

vortexDataUnavailable 400

Los datos que se transmitieron recientemente con la API de BigQuery Storage Write (gRPC) al almacenamiento optimizado para escritura no están disponibles de forma temporal para una consulta. El error devuelve lo siguiente: Job failed because vortex streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem.

Vuelve a intentar el trabajo de consulta con un jobId nuevo usando la retirada exponencial truncada, lo que garantiza que la lógica de reintento del cliente controle las respuestas HTTP 400. Para obtener más información, consulta Los datos de transmisión no están disponibles temporalmente.

billingTierLimitExceeded 400

Una consulta on demand supera el límite máximo de uso de CPU por datos analizados. El error devuelve lo siguiente: 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.

Refactoriza tu SQL para quitar productos cartesianos no deseados, uniones inexactas, funciones analíticas sin particiones o UDF de JavaScript pesadas, o cambia a precios basados en la capacidad (ranuras). Para obtener más información, consulta La consulta excede los recursos de CPU y Evita los antipatrones de SQL.

bytesBilledLimitExceeded 400

La estimación de bytes de límite superior previa a la ejecución de una consulta supera maximumBytesBilled antes de que comience la ejecución. El error devuelve lo siguiente: Query exceeded limit for bytes billed: limit_bytes. required_bytes or higher required.

Obtén una vista previa de los bytes estimados con una ejecución de prueba, selecciona solo las columnas necesarias y filtra las columnas particionadas para reducir el procesamiento de datos, o bien aumenta maximumBytesBilled a, al menos, required_bytes. Para obtener más información, consulta La consulta supera el límite máximo de bytes facturados.

jobRateLimitExceeded 400

En jobs.query o jobs.getQueryResults, un trabajo falla por uno de los siguientes motivos:

  • El trabajo supera un límite de frecuencia durante la ejecución (Job exceeded rate limits: Your scope exceeded quota for quota_metric...).
  • La consulta no se admite porque se alcanzó la simultaneidad de la cola de consultas o el límite de ranuras de consultas continuas (por ejemplo, Query was not admitted as the maximum concurrency has been reached...).

Reduce los envíos simultáneos (o usa la prioridad por lotes o el ajuste de escala automático de ranuras para las consultas continuas) y vuelve a intentar el trabajo con un jobId nuevo usando la retirada exponencial truncada. Para obtener más información, consulta El trabajo superó los límites de frecuencia y Se rechazó la admisión de la consulta.

timeout 400

Una operación excede su límite de tiempo de ejecución, incluidos los siguientes casos:

  • Una consulta o una ejecución de prueba supera el límite de ejecución de 6 horas.
  • Se agota el tiempo de espera de un trabajo secundario dentro de una consulta de varias instrucciones.
  • Se agota el tiempo de espera de la detección automática del esquema de la tabla externa.

Filtra por columnas particionadas o agrupadas, y divide las consultas complejas o de varias declaraciones en etapas más pequeñas, o especifica un esquema explícito y URIs de origen más estrechos cuando crees tablas externas. Para obtener más información, consulta La consulta supera el límite de tiempo de ejecución y Soluciona problemas de cuota y limita errores.

invalidUser 400

Se configuró una consulta programada con credenciales de usuario no válidas.

Actualiza las credenciales del usuario para la consulta programada. Para obtener más información, consulta Programa consultas.

required 400

Falta una entrada obligatoria antes de la ejecución:

  • No se proporcionó un campo obligatorio en la carga útil o la URL de una solicitud a la API.
  • Un objeto de configuración obligatorio en una biblioteca cliente está vacío o no se asignó.

El error devuelve lo siguiente: Required parameter is missing: parameter_name.

Verifica el cuerpo de la solicitud y los parámetros de consulta obligatorios en la referencia de la API de BigQuery o en la documentación de la biblioteca cliente, y, luego, inspecciona el objeto de configuración antes de llamar a la API. Para obtener más información, consulta Falta un parámetro obligatorio.

401 — Unauthorized

El siguiente es un ejemplo de una respuesta de error que recibes si tu solicitud no tiene credenciales de autenticación 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 estado HTTP Descripción Soluciona problemas
unauthenticated 401

La autenticación de la solicitud falla por uno de los siguientes motivos:

  • La solicitud no tiene credenciales de autenticación válidas o usa un token de acceso de OAuth 2.0 vencido.
  • Faltan las credenciales del usuario final o los permisos de identidad temporal como cuenta de servicio.
  • La cuenta de usuario del emisor está restringida o borrada.

Actualiza tus credenciales predeterminadas de la aplicación o de OAuth, otorga roles/iam.serviceAccountUser o roles/iam.serviceAccountTokenCreator cuando ejecutes o suplantes una cuenta de servicio, o comunícate con tu administrador para restablecer una cuenta restringida. Para obtener más información, consulta Soluciona problemas de errores no autenticados.

403: Prohibido

Este es un ejemplo de una respuesta de error que recibes si no tienes permiso para acceder al 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 estado HTTP Descripción Soluciona problemas
responseTooLarge 403

Una respuesta de lectura de consulta o tabla supera los límites de tamaño de una de las siguientes maneras:

El error devuelve lo siguiente: Response too large to return. details.

Especifica una tabla de destino (y establece configuration.query.allowLargeResults en true para SQL heredado), quita ORDER BY o agrega LIMIT, o lee filas grandes con la API de BigQuery Storage Read o EXPORT DATA. Para obtener más información, consulta La respuesta de la consulta es demasiado grande y Se superó el límite de tamaño de la respuesta de una sola fila.

apiLimitExceeded 403

Una solicitud supera uno de los siguientes límites de API o metadatos:

  • Límites de frecuencia de las solicitudes a la API por minuto.
  • Cuotas de evaluación de metadatos de tablas o políticas.
  • Límites de creación de réplicas de conjuntos de datos entre regiones (Cannot add more than limit replicas for a region within window day(s)).

El error devuelve lo siguiente: API limit exceeded: details.

Vuelve a intentar las solicitudes con errores con retirada exponencial truncada, cargas y lecturas por lotes, simplifica las políticas de seguridad detalladas de IAM por tabla o a nivel de fila, y espera la ventana móvil antes de agregar réplicas de conjuntos de datos. Para obtener más información, consulta Errores de límite de evaluación de metadatos y de frecuencia de la API y Errores de límite de creación de réplicas de conjuntos de datos entre regiones.

quotaExceeded 403

Tu proyecto supera una de las siguientes cuotas de uso:

El error devuelve lo siguiente: Quota exceeded: Your scope exceeded quota for quota_metric. For more information, see https://cloud.google.com/bigquery/docs/troubleshoot-quotas.

Inspecciona el error message para identificar la cuota excedida, optimiza las consultas de análisis alto o actualiza desde la zona de pruebas, o ajusta las cuotas personalizadas en la página Cuotas. Para obtener más información, consulta Errores de cuota de consulta diaria personalizada.

rateLimitExceeded 403

Se rechaza una solicitud por uno de los siguientes límites de frecuencia o simultaneidad:

  • Límites de frecuencia de trabajos de consulta o de la API a corto plazo (Exceeded rate limits: too many quota_metric for this scope...).
  • Simultaneidad de la cola de consultas o límites de ranuras de reserva de consultas continuas (por ejemplo, Query was not admitted as the maximum concurrency has been reached...).

Disminuye el porcentaje de solicitudes y vuelve a intentarlo con una retirada exponencial truncada, o ejecuta consultas no urgentes con prioridad por lotes y ajusta la simultaneidad de las reservas o el ajuste de escala automático de ranuras. Para obtener más información, consulta Soluciona problemas de cuota y limita errores y Admisión de consultas denegada.

accessDenied 403

Se deniega el acceso a un recurso de BigQuery por uno de los siguientes motivos:

  • La principal no tiene los permisos de IAM necesarios en el proyecto, el conjunto de datos o la tabla de destino.
  • Una vista autorizada, una política de acceso a nivel de fila o una etiqueta de política a nivel de columna restringen el acceso.
  • Faltan los permisos de CMEK de Cloud Key Management Service o los permisos de la fuente de datos externa.

El error devuelve lo siguiente: Access Denied: resource_type resource_id: details.

Inspecciona los registros de auditoría de Cloud (protoPayload.authorizationInfo) y el Analizador de políticas para identificar el permiso faltante y otorgar el rol predefinido de BigQuery con privilegios mínimos. Para obtener más información, consulta Soluciona problemas comunes de acceso denegado.

policyViolation 403

Un perímetro de seguridad o una política de la organización bloquean la solicitud:

  • Un perímetro de Controles del servicio de VPC restringe el acceso (incluidas las exportaciones de Google Drive o las tablas externas en proyectos de VPC-SC).
  • Una restricción de la política de la organización, como constraints/gcp.resourceLocations, no permite la operación.

Filtra el Explorador de registros por vpcServiceControlsUniqueIdentifier y verifica el Analizador de incumplimientos, exporta o carga datos con un bucket de Cloud Storage dentro del perímetro, o selecciona una región permitida por las restricciones de la política de la organización. Para obtener más información, consulta Cómo solucionar problemas de incumplimiento de política.

billingNotEnabled 403

El proyecto no tiene una facturación activa para la operación solicitada:

  • La facturación no está habilitada para el proyecto.
  • El proyecto se ejecuta en la zona de pruebas de BigQuery, en la que las tablas, las vistas y las particiones vencen después de 60 días (expiration time must be less than 60 days).

El error devuelve lo siguiente: Billing has not been enabled for this project. Enable billing at https://console.cloud.s3nscloud.fr/billing. details.

Habilita la facturación para el proyecto en la consola deCloud de Confiance para actualizar desde la zona de pruebas de BigQuery y, luego, actualiza los tiempos de vencimiento predeterminados para tus tablas, vistas y particiones. Para obtener más información, consulta La facturación no está habilitada para el proyecto.

blocked 403

BigQuery agregó de forma temporal la operación que se intentó realizar a una lista de bloqueo para evitar una interrupción del servicio. El error devuelve lo siguiente: Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support.

Comunícate con el equipo de Atención al cliente de Cloud con la marca de tiempo exacta, el ID del proyecto y el ID del trabajo de BigQuery para investigar la regla de mitigación administrativa. Para obtener más información, consulta Se bloqueó la solicitud para proteger el funcionamiento del sistema.

termsOfServiceNotAccepted 403

No se aceptaron las Condiciones del Servicio de BigQuery para el proyecto. El error devuelve: BigQuery Terms of Service have not been accepted.

Accede a la consola deCloud de Confiance , selecciona tu país y la casilla de verificación de las Condiciones del Servicio en la página de bienvenida si se te solicita, y haz clic en Aceptar y continuar. Para obtener más información, consulta No se aceptaron las Condiciones del Servicio de BigQuery.

404: No encontrado

A continuación, se muestra un ejemplo de una respuesta de error que recibes si intentas recuperar un conjunto de datos o un recurso que no 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 estado HTTP Descripción Soluciona problemas
notFound 404

No se puede encontrar un recurso solicitado por uno de los siguientes motivos:

  • El conjunto de datos, la tabla o el trabajo de destino no existe o venció.
  • No existe un URI de archivo externo de Cloud Storage o Google Drive.
  • La ubicación de la solicitud no coincide con la ubicación del conjunto de datos o del trabajo.

El error devuelve lo siguiente: Not found: resource_type resource_id.

Verifica el identificador y la ubicación exactos del proyecto, el conjunto de datos y la tabla que distinguen mayúsculas de minúsculas, restablece las tablas borradas dentro de la ventana de viaje en el tiempo, vuelve a ejecutar las consultas cuyas tablas de resultados almacenadas en caché vencieron o confirma que existen archivos externos de Cloud Storage o Google Drive. Para obtener más información, consulta No se encontró la tabla, No se encontró la ubicación y No se encontró el trabajo.

409: Conflicto

A continuación, se muestra un ejemplo de una respuesta de error que recibes si intentas crear un recurso que ya 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 estado HTTP Descripción Soluciona problemas
abortd 409

Una operación se detiene debido a una modificación o un conflicto simultáneos (se devuelve con el motivo escrito abortd).

Vuelve a intentar la operación después de que finalice la operación en conflicto con la retirada exponencial truncada o revierte las transacciones con varias declaraciones detenidas antes de volver a intentarlo. Para obtener más información, consulta Se anuló la operación.

duplicate 409

Una solicitud entra en conflicto con un recurso existente de una de las siguientes maneras:

  • Crear un recurso de conjunto de datos, tabla o trabajo que ya existe.
  • Ejecutar un trabajo con writeDisposition configurado como WRITE_EMPTY cuando la tabla de destino ya existe

El error devuelve lo siguiente: Already Exists: resource_type resource_id.

Usa un nombre de recurso diferente, usa IF NOT EXISTS o CREATE OR REPLACE en las declaraciones de DDL, cambia writeDisposition por WRITE_APPEND o WRITE_TRUNCATE, o permite que BigQuery genere un jobId aleatorio. Para conocer los pasos por subtipo, consulta El recurso ya existe.

499: El cliente cerró la solicitud

Motivo Código de estado HTTP Descripción Soluciona problemas
stopped 499

Un trabajo se detiene antes de completarse por uno de los siguientes motivos (el sondeo jobs.get devuelve HTTP 200 con reason: stopped):

  • Un emisor cancela el trabajo de forma explícita (User requested cancellation).
  • El trabajo supera el tiempo de espera de ejecución o de cola configurado (Job timed out after duration o Job timed out in the queue after duration).

El error devuelve lo siguiente: Job execution was cancelled: details.

Aumenta las opciones de tiempo de espera de la cola de proyectos o configuration.jobTimeoutMs (u optimiza el tiempo de ejecución y la simultaneidad de las consultas), o bien consulta los Registros de auditoría de Cloud para ver las llamadas a jobservice.cancel. Para conocer los pasos por subtipo, consulta Se canceló la ejecución del trabajo.

500: Error interno del servidor

Motivo Código de estado HTTP Descripción Soluciona problemas
internalError 500

Se produjo un error interno en BigQuery. El error devuelve lo siguiente: An internal error occurred and the request could not be completed.

Espera según los requisitos de retirada en el Acuerdo de Nivel de Servicio de BigQuery y vuelve a intentarlo con la retirada exponencial truncada, o usa Reservas para reducir la frecuencia de errores transitorios. Para obtener más información, consulta Soluciona errores internalError.

501: No implementado

Motivo Código de estado HTTP Descripción Soluciona problemas
notImplemented 501

Una solicitud intenta usar una función o una operación no implementada para el recurso objetivo, como las siguientes:

  • Copiar una tabla con un tipo de almacenamiento no administrado
  • Ejecutar una opción ALTER SEARCH INDEX no compatible

El error devuelve lo siguiente: Not Implemented: details.

Materializa las fuentes de copia de tablas no compatibles con CREATE TABLE destination_table AS SELECT * FROM source_table, o descarta y vuelve a crear índices de búsqueda con DROP SEARCH INDEX y CREATE SEARCH INDEX. Para conocer los pasos por subtipo, consulta La función o la operación no se implementó.

503: Servicio no disponible

Motivo Código de estado HTTP Descripción Soluciona problemas
backendError 503

El servicio no está disponible temporalmente por uno de los siguientes motivos:

  • Un aumento repentino en la demanda del servicio (reducción de carga) o el agotamiento de los recursos internos.
  • Problemas intermitentes de conectividad de red.
  • Un problema transitorio con el componente de backend.

El error devuelve lo siguiente: Error encountered during execution. Retrying may solve the problem.

Vuelve a intentar las solicitudes con la retirada exponencial truncada y vuelve a intentar los trabajos con errores con un jobId nuevo. Si los errores persisten en los reintentos, compara tu tasa de fallas de 30 días con el ANS de BigQuery y comunícate con Atención al cliente de Cloud; consulta Soluciona errores de backendError.