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 les actions recommandées pour les résoudre.

Erreurs générales:

  • Saisies client non valides:

    • "ResourceName error Path [NOM_RESSOURCE] ne correspond pas au modèle [NOM_RESSOURCE]."
    • "Remplacement de l'annuaire d'entrepôt incorrect: [GCS_URI]."
    • "L'objet krb5.conf fourni est krb5Config non valide."
  • État de la ressource API non valide:

    • "L'état actuel de la ressource [NOM_RESSOURCE] n'est pas 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 ce 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 suffisantes pour accéder au réseau [NETWORK]. Veuillez vous assurer que l'agent de service dispose des rôles roles/metastore.serviceAgent dans le projet [PROJECT_NUMBER]."

    • "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."

    • "Le bucket Cloud Storage du répertoire d'entrepôt fourni [GCS_URI] n'est pas lisible et 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. Ce type d'erreur peut être déclenché par de nombreux éléments différents, par exemple:

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

    Le chemin d'erreur [RESOURCE_NAME] ne correspond pas au modèle [RESOURCE_MODEL].

  • Le répertoire de l'entrepôt n'était pas un chemin d'accès Cloud Storage valide. Pour en savoir plus, consultez la page Stockage de données pour les tables internes.

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

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

    L'objet krb5Config fourni (krb5Config) n'est pas valide.

Action recommandée : Corrigez votre requête.

État de la ressource API incorrect

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 [NOM_RESSOURCE] n'est pas valide pour cette opération. Les états valides sont les suivants : [RESOURCE_STATE].

Cela peut se produire si la ressource API (service Dataproc Metastore, importation, exportation, sauvegarde ou restauration) n'est pas dans l'état approprié 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 ce 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 se trouve 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 Dataproc.

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 à la suppression d'un compte de service ou à la modification de ses autorisations, par exemple:

  • 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 le répertoire de l'entrepôt Hive.

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

  • Vous avez utilisé un réseau appartenant à un autre projet, mais n'avez pas autorisé l'agent de service Dataproc Metastore à y accéder. Pour en savoir plus, consultez la section Créer un service.

    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 à l'annuaire d'entrepôts dans Cloud Storage.

Le bucket Cloud Storage du répertoire d'entrepôt fourni [GCS_URI] n'est pas lisible et 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 relatives à l'importation et à l'exportation

Cette section décrit les erreurs relatives à l'importation et l'exportation.

Importer et exporter des autorisations Cloud Storage

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 suffisantes pour accéder à l'URI Cloud Storage permettant d'effectuer des importations/exportations ([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 à partir de fichiers Avro n'est pas compatible avec la version Hive [HIVE_METASTORE_VERSION]. Les versions compatibles sont les suivantes : [SUPPORT_HIVE_VERSIONS].

Action recommandée:Consultez la page Politique de version pour obtenir la compatibilité la plus récente des versions de Hive. Mettez à jour vos fichiers de base de données vers une version compatible.

Tables d'importation manquantes

  • 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 corrects de vos fichiers de base de données.

Erreurs liées à la sauvegarde et à la restauration

Cette section décrit les erreurs relatives à 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 pu trouver la ressource de sauvegarde fournie.

Sauvegarde [BACKUP_ID] introuvable.

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

Impossible de supprimer une sauvegarde

Impossible de supprimer une sauvegarde 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.

Étape suivante

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