Mensajes de error

En esta página, se explican los mensajes de error comunes que puedes recibir cuando usas Dataproc Metastore. En cada sección, se incluye más información sobre el significado de los mensajes y las acciones recomendadas para resolver los errores.

Errores generales:

  • Entradas no válidas del cliente:

    • "La ruta de error ResourceName [RESOURCE_NAME] no coincide con la plantilla [RESOURCE_TEMPLATE]".
    • "Anulación del directorio del almacén no válido: [GCS_URI]"
    • "El objeto krb5.conf proporcionado krb5Config no es válido".

  • Estado del recurso de API no válido:

    • “El estado actual del recurso [RESOURCE_NAME] no es un estado válido para esta operación. Los estados válidos son [RESOURCE_STATE]”.
    • Intentaste ejecutar una actualización, una importación, una exportación, una copia de seguridad o un restablecimiento en un servicio de Dataproc Metastore, pero el servicio no era ACTIVE.
    • "La copia de seguridad [BACKUP_ID] no está lista".

  • Permiso de acceso a la API:

    • No tenías permisos suficientes para llamar a las APIs de Dataproc Metastore.

  • Permisos insuficientes del agente de servicio:

    • “El agente de servicio de Dataproc Metastore [SERVICE_AGENT] no tiene suficientes permisos de IAM para acceder a la red [NETWORK]. Asegúrate de que al agente de servicio se le otorguen roles/metastore.serviceAgent en el proyecto [PROJECT_NUMBER]”.

    • "El agente de servicio de Dataproc Metastore no puede acceder al URI [GCS_URI] de Cloud Storage con los permisos [SERVICE_AGENT_PERMISSIONS]. Verifica los permisos o el perímetro de servicio de los Controles del servicio de VPC".

    • “El agente de servicio de Dataproc Metastore no puede leer ni escribir el bucket de Cloud Storage [GCS_URI] del directorio de almacenes proporcionado”.

Errores relacionados con la importación y exportación:

Errores relacionados con la copia de seguridad y el restablecimiento:

Errores generales

En esta sección, se explican los errores generales.

Las entradas del cliente no son válidas

Este es un error genérico que significa que algo relacionado con tu solicitud no es válido, independientemente del estado del servidor. Este tipo de error podría ser provocado por muchos motivos diferentes, como los siguientes:

  • Cuando usaste la API de REST, especificaste el nombre de una red en un formato no válido.

    La ruta de acceso del error ResourceName [RESOURCE_NAME] no coincide con la plantilla [RESOURCE_TEMPLATE].

  • El directorio del almacén no era una ruta de Cloud Storage válida. Para obtener más información, consulta Hive Metastore.

    Anulación del directorio de almacén no válido: [GCS_URI].

  • Especificaste opciones de configuración de Kerberos no válidas (consulta Configurar Kerberos para un servicio).

    El objeto krb5.conf proporcionado (krb5Config) no es válido.

Acción recomendada: Corrige tu solicitud.

Estado de recurso de API no válido

Este es un error genérico que significa que algo relacionado con la solicitud no es compatible con el estado actual del recurso del servidor.

El estado actual del recurso [RESOURCE_NAME] no es un estado válido para esta operación. Los estados válidos son [RESOURCE_STATE].

Esto puede suceder si el recurso de API (importación, exportación, copia de seguridad, restablecimiento o servicio de Dataproc Metastore) no está en el estado correcto para realizar la acción, por ejemplo:

  • Intentaste ejecutar una actualización, una importación, una exportación, una copia de seguridad o un restablecimiento en un servicio de Dataproc Metastore, pero el servicio no era ACTIVE.

  • Intentaste restablecer una copia de seguridad y el servicio de Dataproc Metastore era ACTIVE, pero la copia de seguridad no era ACTIVE.

    La copia de seguridad [BACKUP_ID] no está lista.

Acción recomendada: Comprueba que tu recurso de API esté en el estado correcto antes de reintentar la solicitud.

Permiso de acceso a la API

No tenías permisos suficientes para llamar a las APIs de Dataproc Metastore.

Acción recomendada: Otorga al usuario los permisos de IAM de Dataproc Metastore correctos.

Permisos del agente de servicio insuficientes

Recibiste un error de permisos cuando creaste recursos en tu proyecto. Por lo general, el error se debe a una cuenta de servicio borrada o a permisos de cuenta de servicio modificados, por ejemplo:

  • Usaste una red que pertenece a un proyecto diferente, pero no otorgaste permiso al agente de servicio de Dataproc Metastore para acceder a ella. Para obtener más información, consulta Implementación entre proyectos.

    El agente de servicio de Dataproc Metastore [SERVICE_AGENT] no tiene suficientes permisos de IAM para acceder a la red [NETWORK]. Asegúrate de que al agente de servicio se le haya otorgado el rol roles/metastore.serviceAgent en el proyecto [PROJECT_NUMBER].

  • Proporcionaste un bucket de almacén de datos personalizado de Cloud Storage, pero no otorgaste al agente de servicio de Dataproc Metastore permiso para acceder a él. Para obtener más información, consulta el directorio del almacén de Hive.

    "El agente de servicio de Dataproc Metastore no puede acceder al URI [GCS_URI] de Cloud Storage con los permisos [SERVICE_AGENT_PERMISSIONS]. Verifica los permisos o el perímetro de servicio de los Controles del servicio de VPC".

O bien, Dataproc Metastore no pudo acceder a la ruta de acceso de Cloud Storage del directorio del almacén.

El agente de servicio de Dataproc Metastore no puede leer ni escribir el bucket de Cloud Storage [GCS_URI] del directorio de almacenamiento proporcionado.

Acción recomendada: Verifica los permisos de la cuenta de servicio o el perímetro de servicio de los Controles del servicio de VPC.

Errores relacionados con la importación y exportación

En esta sección, se explican los errores relacionados con la importación y la exportación.

Importa y exporta permisos de Cloud Storage

Tu agente de servicio de Dataproc Metastore no tenía suficientes permisos para realizar la importación o exportación.

El “agente de servicio de Dataproc Metastore” o el “llamador” no tiene permisos suficientes del URI de Cloud Storage para la importación y exportación ([SERVICE_AGENT] no puede acceder al URI de Cloud Storage [GCS_URI] con los permisos [SERVICE_AGENT_PERMISSIONS]).

Acción recomendada: Verifica los permisos de la cuenta de servicio o el perímetro de servicio de los Controles del servicio de VPC.

Ejecutar la importación o exportación de Avro en una versión no compatible de Hive

La versión de Hive [HIVE_METASTORE_VERSION] no es compatible con la importación desde archivos Avro. Las versiones compatibles son [SUPPORT_HIVE_VERSIONS].

Acción recomendada: Consulta Política de versiones para obtener la compatibilidad con la versión de Hive más actualizada. Actualiza los archivos de tu base de datos a una versión compatible.

Faltan tablas de importación

  • Para la importación de Avro

    No se encontraron los archivos fuente de Avro para las tablas [MISSING_TABLE_LIST].

  • Para la importación de SQL

    No se pudo validar el esquema de Hive. Faltan tablas: [MISSING_TABLE_LIST].

Acción recomendada: Usa Dataproc Metastore Toolkit como referencia para verificar los esquemas de metadatos de Hive correctos de tus archivos de la base de datos.

Errores relacionados con la copia de seguridad y el restablecimiento

En esta sección, se explican los errores relacionados con la copia de seguridad y el restablecimiento.

No se encontró la copia de seguridad para el restablecimiento

Cuando restableciste una copia de seguridad en un servicio, Dataproc Metastore no pudo encontrar el recurso de copia de seguridad proporcionado.

No se encontró la copia de seguridad [BACKUP_ID].

Acción recomendada: Comprueba que la copia de seguridad exista dentro de tu servicio de Dataproc Metastore.

No se puede borrar una copia de seguridad

No se pudo borrar una copia de seguridad cuando se usaba para restablecer un servicio.

No se puede borrar una copia de seguridad en el estado [RESOURCE_STATE].

Acción recomendada: Espera a que se complete el trabajo de restablecimiento antes de intentar borrar la copia de seguridad.

¿Qué sigue?

  • Para encontrar soluciones a problemas comunes que puedes encontrar cuando usas Dataproc Metastore, consulta Solución de problemas.