Messages d'erreur

Cette page explique les messages d'erreur courants que vous pouvez recevoir lors de l'utilisation de Dataproc Metastore. Chaque section contient des informations supplémentaires sur la signification des messages et sur les actions recommandées pour les résoudre.

Erreurs générales :

  • Entrées client non valides:

    • "L'erreur de chemin d'accès ResourceName [RESOURCE_NAME] ne correspond pas au modèle [RESOURCE_TEMPLATE]."
    • "Remplacement du répertoire de l'entrepôt non valide: [GCS_URI]."
    • "L'objet krb5.conf krb5Config fourni n'est pas valide."

  • État de la ressource API non valide:

    • "L'état actuel de la ressource [RESOURCE_NAME] n'est pas un état valide pour cette opération. Les états valides sont [RESOURCE_STATE]."
    • Vous avez essayé d'exécuter une mise à jour, une importation, une exportation, une sauvegarde ou une restauration sur un service Dataproc Metastore, mais le service n'était pas ACTIVE.
    • "Sauvegarde [BACKUP_ID] non prête."

  • Autorisation d'accès à l'API:

    • Vous ne disposez pas des autorisations nécessaires pour appeler les API Dataproc Metastore.

  • Autorisations d'agent de service insuffisantes:

    • "L'agent de service Dataproc Metastore [SERVICE_AGENT] ne dispose pas des autorisations IAM nécessaires pour accéder au réseau [RÉSEAU]. Assurez-vous que l'agent de service dispose de roles/metastore.serviceAgent dans le projet [PROJECT_NUMBER]."

    • "L'agent de service Dataproc Metastore ne peut pas accéder à l'URI [GCS_URI] Cloud Storage avec les autorisations [SERVICE_AGENT_PERMISSIONS]. Veuillez vérifier les autorisations ou le périmètre de service VPC Service Controls."

    • "Le bucket Cloud Storage du répertoire d'entrepôt fourni [GCS_URI] n'est pas lisible ni accessible en écriture par l'agent de service Dataproc Metastore."

Erreurs d'importation et d'exportation:

Erreurs liées à la sauvegarde et à la restauration:

Erreurs générales

Cette section explique les erreurs générales.

Entrées client non valides

Il s'agit d'un message d'erreur générique indiquant qu'un élément de votre requête n'est pas valide. Ce type de message n'est pas lié à l'état du serveur. Les opérations pouvant entraîner cette erreur sont multiples, par exemple :

  • Lorsque vous utilisez l'API REST, vous avez spécifié le nom d'un réseau dans un format non valide.

    L'erreur de chemin d'accès ResourceName [RESOURCE_NAME] ne correspond pas au modèle [RESOURCE_TEMPLATE].

  • Le répertoire de l'entrepôt n'est pas un chemin d'accès Cloud Storage valide. Pour en savoir plus, consultez Hive Metastore.

    Remplacement du répertoire de l'entrepôt non valide: [GCS_URI].

  • Vous avez spécifié des configurations Kerberos non valides (consultez la page Configurer Kerberos pour un service).

    L'objet krb5.conf krb5Config fourni n'est pas valide.

Action recommandée : Corrigez votre requête.

État de la ressource API non valide

Il s'agit d'un message d'erreur générique indiquant qu'un élément de la requête n'est pas compatible avec l'état actuel de la ressource serveur.

L'état actuel de la ressource [RESOURCE_NAME] n'est pas valide pour cette opération. Les états valides sont [RESOURCE_STATE].

Cela peut se produire si la ressource API (service Dataproc Metastore, importation, exportation, sauvegarde ou restauration) n'est pas dans le bon état pour effectuer l'action, par exemple:

  • Vous avez essayé d'exécuter une mise à jour, une importation, une exportation, une sauvegarde ou une restauration sur un service Dataproc Metastore, mais le service n'était pas ACTIVE.

  • Vous avez essayé de restaurer une sauvegarde. Le service Dataproc Metastore était ACTIVE, mais la sauvegarde n'était pas ACTIVE.

    La sauvegarde [BACKUP_ID] n'est pas prête.

Action recommandée:Vérifiez que votre ressource d'API est dans le bon état avant de relancer la requête.

Autorisation d'accès à l'API

Vous ne disposez pas des autorisations nécessaires pour appeler les API Dataproc Metastore.

Action recommandée:Accordez à l'utilisateur les autorisations IAM Dataproc Metastore appropriées.

Autorisations d'agent de service insuffisantes

Vous avez reçu une erreur d'autorisation lors de la création de ressources dans votre projet. L'erreur est généralement due à une suppression de compte de service ou à des autorisations de modification de compte de service, par exemple:

  • Vous avez utilisé un réseau appartenant à un projet différent, mais vous n'avez pas accordé à l'agent de service Dataproc Metastore les autorisations pour y accéder. Pour en savoir plus, consultez la section Déploiement multiprojets.

    L'agent de service Dataproc Metastore [SERVICE_AGENT] ne dispose pas des autorisations IAM nécessaires pour accéder au réseau [NETWORK]. Assurez-vous que l'agent de service dispose de roles/metastore.serviceAgent dans le projet [PROJECT_NUMBER].

  • Vous avez fourni un bucket Cloud Storage d'entrepôt de données personnalisé, mais vous n'avez pas autorisé l'agent de service Dataproc Metastore à y accéder. Pour en savoir plus, consultez la section Répertoire d'entrepôt Hive.

    L'agent de service Dataproc Metastore ne peut pas accéder à l'URI Cloud Storage [GCS_URI] avec les autorisations [SERVICE_AGENT_PERMISSIONS]. Veuillez vérifier les autorisations ou le périmètre de service VPC Service Controls.

Ou Dataproc Metastore n'a pas pu accéder au chemin d'accès Cloud Storage du répertoire d'entrepôt.

Le bucket Cloud Storage du répertoire d'entrepôt fourni [GCS_URI] n'est pas lisible ni accessible en écriture par l'agent de service Dataproc Metastore.

Action recommandée:Vérifiez les autorisations de votre compte de service ou le périmètre de service VPC Service Controls.

Erreurs d'importation et d'exportation

Cette section explique les erreurs liées à l'importation et à l'exportation.

Autorisations Cloud Storage pour l'importation et l'exportation

Votre agent de service Dataproc Metastore ne dispose pas des autorisations nécessaires pour effectuer l'importation ou l'exportation.

L'agent de service "Dataproc Metastore" ou l'"appelant" ne dispose pas des autorisations nécessaires de l'URI Cloud Storage pour importer/exporter ([SERVICE_AGENT] ne peut pas accéder à l'URI Cloud Storage [GCS_URI] avec les autorisations [SERVICE_AGENT_PERMISSIONS]).

Action recommandée:Vérifiez les autorisations de votre compte de service ou le périmètre de service VPC Service Controls.

Exécuter une importation ou une exportation Avro sur une version Hive non compatible

L'importation depuis des fichiers Avro n'est pas compatible avec la version Hive [HIVE_METASTORE_VERSION], et les versions compatibles sont [SUPPORT_HIVE_VERSIONS].

Action recommandée:Consultez la section Stratégie de version pour obtenir la version la plus récente compatible Hive. Mettez à jour vos fichiers de base de données vers une version compatible.

Tables d'importation manquantes

  • Pour l'importation au format Avro

    Fichiers sources Avro introuvables pour les tables [MISSING_TABLE_LIST].

  • Pour l'importation SQL

    Échec de la validation du schéma Hive. Tables manquantes: [MISSING_TABLE_LIST].

Action recommandée:Utilisez le kit Dataproc Metastore comme référence pour vérifier les schémas de métadonnées Hive appropriés de vos fichiers de base de données.

Erreurs liées à la sauvegarde et à la restauration

Cette section explique les erreurs liées à la sauvegarde et à la restauration.

Sauvegarde introuvable pour la restauration

Lors de la restauration d'une sauvegarde dans un service, Dataproc Metastore n'a pas trouvé la ressource de sauvegarde fournie.

Sauvegarde [BACKUP_ID] introuvable.

Action recommandée:Vérifiez que votre sauvegarde existe dans votre service Dataproc Metastore.

Impossible de supprimer une sauvegarde

Vous ne pouvez pas supprimer une sauvegarde lorsqu'elle était utilisée pour restaurer un service.

Impossible de supprimer une sauvegarde dans un état [RESOURCE_STATE].

Action recommandée:Attendez la fin de la tâche de restauration avant de tenter de supprimer la sauvegarde.

Étapes suivantes

  • Pour trouver des solutions aux problèmes courants que vous pouvez rencontrer lors de l'utilisation de Dataproc Metastore, consultez la page Dépannage.