Résoudre les problèmes de configuration du cluster

Important

Azure HDInsight sur AKS a été mis hors service le 31 janvier 2025. En savoir plus avec cette annonce.

Vous devez migrer vos charges de travail vers Microsoft Fabric ou un produit Azure équivalent pour éviter l’arrêt brusque de vos charges de travail.

Important

Cette fonctionnalité est actuellement en préversion. Les Conditions d’utilisation supplémentaires pour les préversions Microsoft Azure incluent des termes juridiques supplémentaires qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou qui ne sont pas encore publiées en disponibilité générale. Pour plus d’informations sur cette préversion spécifique, consultez des informations en préversion sur Azure HDInsight sur AKS. Pour des questions ou des suggestions de fonctionnalités, envoyez une demande sur AskHDInsight avec les détails et suivez-nous pour plus de mises à jour sur Communauté Azure HDInsight.

Une configuration de cluster incorrecte peut entraîner des erreurs de déploiement. En règle générale, ces erreurs se produisent quand une configuration incorrecte est fournie dans un modèle ARM ou qu'une entrée est incorrecte dans le portail Azure, par exemple, sur la page de gestion de la configuration.

Note

Ces erreurs auront pour raison de commencer par le préfixe « Utilisateur ».

Exemple d’erreur de configuration :

Le tableau suivant fournit des codes d’erreur et leur description pour faciliter le diagnostic et la résolution des erreurs courantes.

Erreurs de configuration

Code d’erreur	Description
User.TrinoError	Le démarrage du processus Trino échoue avec une erreur générique. Vérifiez les fichiers de configuration spécifiques trino dans profil de configuration de service.
User.Configuration.TrinoError	Le démarrage du processus Trino échoue avec l’erreur de configuration de l’application. Vérifiez les fichiers de configuration spécifiques trino dans profil de configuration de service.
Configuration.Utilisateur.FichierInterdit	Les modifications apportées à certains fichiers de configuration trino ne sont pas autorisées.
Utilisateur.Configuration.ParamètreInterdit	Les modifications apportées à certains paramètres de configuration trino ne sont pas autorisées.
Configuration.Utilisateur.ComposantInvalide	Composant de service non valide spécifié. Pour plus d’informations, consultez le profil de configuration de service .
Utilisateur.Configuration.FichierDivers.NomInvalide	Nom de fichier divers non valide. Pour plus d’informations, consultez , fichiers divers.
User.Configuration.MiscFile.InvalidPath	Le chemin de fichier est trop long.
Utilisateur.Configuration.FichierDivers.NonTrouvé	Une balise MISC a été trouvée sans fichier correspondant dans la configuration de fichiers divers. Pour plus d'informations, consultez les fichiers divers .
User.Configuration.MiscFile.NomDupliqué	Valeur dupliquée trouvée pour fileName dans la section de configuration fichiers divers.
User.Configuration.MiscFile.DuplicatePath	Valeur de chemin d’accès en double trouvée dans fichiers divers section de configuration.
User.Configuration.FormatError	Configuration de service incorrecte, propriétés de contenu/valeurs utilisées dans des sections incorrectes. Pour plus d’informations, consultez profil de configuration de service.
Configuration.Utilisateur.HiveMetastore.MotsDePasseMultiples	Plusieurs mots de passe spécifiés dans le catalogue catalogOptions.hive. Spécifiez l’une des deux propriétés metastoreDbConnectionPasswordSecret ou metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.MotDePasseRequis	Mot de passe requis pour le catalogue catalogOptions.hive. Spécifiez l’une des deux propriétés metastoreDbConnectionPasswordSecret ou metastoreDbConnectionPassword.
User.Secrets.Error	Secrets ou autorisations mal configurés dans Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	L'URI Azure Key Vault est manquant dans le secretsProfile.
User.Secrets.KeyVaultUriRequired	URI du coffre de clés Azure manquante dans secretsProfile.
Utilisateur.Secrets.NomDeRéférenceDupliqué	Nom en double trouvé dans secretsProfile.
User.Secrets.KeyVaultObjectUtiliséPlusieursFois	Même objet/version key vault utilisé plusieurs fois comme références différentes dans la liste des secrets dans secretsProfile.
Utilisateur.Secrets.NonSpécifié	Trouvé SECRET_REF balise sans objet secret correspondant dans secretsProfile.
Utilisateur.Secrets.Introuvable	Objet Key Vault spécifié dans secretsProfile introuvable dans KeyVault. Vérifiez le nom, le type et la version de l’objet.
Utilisateur.Plugins.Erreur	Plug-ins ou autorisations mal configurés dans le compte de stockage.
Utilisateur.Plugins.NomDupliqué	Nom du plug-in dupliqué utilisé dans la configuration du cluster userPluginsSpec.
User.Plugins.DuplicatePath	Chemin d’accès du plug-in en double utilisé dans la configuration du cluster userPluginsSpec.
User.Plugins.InvalidPath	URI de stockage mal formé pour un plug-in.
Utilisateur.Modules.CheminNonTrouvé	Chemin d’accès spécifié pour un plug-in introuvable dans le compte de stockage.
Utilisateur.Télémétrie.CheminDeStockageInvalide	URI de stockage mal formé dans userTelemetrySpec.
User.Télémétrie.CatalogueHiveIntrouvable	Un catalogue Hive inexistant a été spécifié comme cible pour les tables de télémétrie dans "userTelemetrySpec".
Utilisateur.OptionsDuCatalogue.HiveCatalogueNonTrouvé	Catalogue Hive introuvable dans les catalogues trino profil de configuration de service pour une configuration catalogOptions.hive donnée. Pour plus d’informations, consultez Hive metastore.

Erreurs système

Certaines erreurs peuvent se produire en raison de conditions d’environnement et être temporaires. Ces erreurs ont pour raison de commencer par « Système ». Dans ce cas, essayez les étapes suivantes :

1. Collectez les informations suivantes :
   1. requête Azure ID de corrélation. Il se trouve dans la zone Notifications ; ou sous Groupe de ressources où se trouve le cluster, dans la page Déploiements ; ou dans la sortie de commande az.
   2. DeploymentId. Elle se trouve dans la page Vue d’ensemble du cluster.
   3. Message d’erreur détaillé.
2. Contactez l’équipe de support technique avec ces informations.

Code d’erreur	Description
Système.ÉchecDeDépendance	Échec dans l’un des composants du cluster.