Dépanner la configuration du cluster

Remarque

Nous allons mettre hors service Azure HDInsight sur AKS le 31 janvier 2025. Avant le 31 janvier 2025, vous devrez migrer vos charges de travail vers Microsoft Fabric ou un produit Azure équivalent afin d’éviter leur arrêt brutal. Les clusters restants de votre abonnement seront arrêtés et supprimés de l’hôte.

Seul le support de base est disponible jusqu’à la date de mise hors service.

Important

Cette fonctionnalité est disponible actuellement en mode Aperçu. Les Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure contiennent davantage de conditions légales qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou ne se trouvant pas encore en disponibilité générale. Pour plus d’informations sur cette préversion spécifique, consultez les Informations sur la préversion d’Azure HDInsight sur AKS. Si vous avez des questions ou des suggestions de fonctionnalités, soumettez une demande sur AskHDInsight avec les détails et suivez-nous pour obtenir les dernières actualités sur la Communauté Azure HDInsight.

Une configuration incorrecte du cluster peut entraîner des erreurs de déploiement. Ces erreurs se produisent généralement en cas de configuration incorrecte fournie dans le modèle ARM ou saisie dans le Portail Microsoft Azure, par exemple sur la page de gestion de la configuration.

Remarque

Ces erreurs auront une raison commençant par « Utilisateur ». préfixe.

Exemple d'erreur de configuration :

Le tableau suivant fournit les codes d'erreur et leur description pour vous aider à diagnostiquer et à corriger les 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 le profil de configuration du service.
User.Configuration.TrinoError	Le démarrage du processus Trino échoue avec une erreur de configuration de l'application. Vérifiez les fichiers de configuration spécifiques à Trino dans le profil de configuration du service.
User.Configuration.FileForbidden	Les modifications apportées à certains fichiers de configuration Trino ne sont pas autorisées.
User.Configuration.ParameterForbidden	Les modifications apportées à certains paramètres de configuration de Trino ne sont pas autorisées.
User.Configuration.InvalidComponent	Composant de service spécifié non valide. Pour plus d'informations, consultez Profil de configuration du service.
User.Configuration.MiscFile.InvalidName	Nom de fichier divers non valide. Pour plus d'informations, voir Fichiers divers.
User.Configuration.MiscFile.InvalidPath	Le chemin du fichier Divers est trop long.
User.Configuration.MiscFile.NotFound	Balise MISC trouvée sans fichier correspondant dans la configuration des fichiers divers. Pour plus d'informations, voir Fichiers divers.
User.Configuration.MiscFile.DuplicateName	Valeur fileName en double trouvée dans la section de configuration des fichiers divers.
User.Configuration.MiscFile.DuplicatePath	Valeur de chemin en double trouvée dans la section de configuration des fichiers divers.
User.Configuration.FormatError	Configuration du service mal formée, propriétés de contenu/valeurs utilisées dans les mauvaises sections. Pour plus d'informations, consultez Profil de configuration du service.
User.Configuration.HiveMetastore.MultiplePasswords	Plusieurs mots de passe spécifiés dans le catalogue catalogOptions.hive. Spécifiez l'une des deux propriétés, soit metastoreDbConnectionPasswordSecret, soit metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PasswordRequired	Mot de passe requis pour le catalogue catalogOptions.hive. Spécifiez l'une des deux propriétés, soit metastoreDbConnectionPasswordSecret, soit metastoreDbConnectionPassword.
User.Secrets.Error	Secrets ou autorisations mal configurés dans Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	URI Azure Key Vault manquant dans secretsProfile.
User.Secrets.KeyVaultUriRequired	URI Azure Key Vault manquant dans secretsProfile.
User.Secrets.DuplicateReferenceName	Nom de référence en double trouvé dans secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	Même objet/version du coffre de clés utilisé plusieurs fois comme différentes références dans la liste des secrets dans secretsProfile.
User.Secrets.NotSpecified	Balise SECRET_REF trouvée sans objet secret correspondant dans secretsProfile.
User.Secrets.NotFound	Objet Key Vault spécifié dans secretsProfile introuvable dans KeyVault. Vérifiez le nom, le type et la version de l'objet.
User.Plugins.Error	Plugins ou autorisations mal configurés dans le compte de stockage.
User.Plugins.DuplicateName	Nom de plugin en double utilisé dans la configuration du cluster userPluginsSpec.
User.Plugins.DuplicatePath	Chemin de plug-in en double utilisé dans la configuration du cluster userPluginsSpec.
User.Plugins.InvalidPath	URI de stockage mal formé pour un plugin.
User.Plugins.PathNotFound	Chemin spécifié pour un plugin introuvable dans le compte de stockage.
User.Telemetry.InvalidStoragePath	URI de stockage mal formé dans userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Catalogue Hive inexistant spécifié comme cible pour les tables de télémétrie dans userTelemetrySpec.
User.CatalogOptions.HiveCatalogNotFound	Catalogue Hive introuvable dans les catalogues Trino Profil de configuration de service pour une configuration catalogOptions.hive donnée. Pour plus d'informations, consultez Metastore Hive.

Erreurs système

Certaines erreurs peuvent survenir en raison des conditions environnementales et être transitoires. Ces erreurs ont une raison commençant par « Système ». comme préfixe. Dans de tels cas, essayez les étapes suivantes :

1. Collectez les informations suivantes :
   1. Requête Azure CorrelationId. Il peut être trouvé soit dans la zone de notifications ; ou sous Groupe de ressources où se trouve le cluster, sur la page Déploiements ; ou dans la sortie de la commande az.
   2. DeploymentId. Il peut être trouvé sur la page Présentation du cluster.
   3. Message d’erreur détaillé.
2. Contactez le support technique avec ces informations.

Code d’erreur	Description
System.DependencyFailure	Défaillance de l'un des composants du cluster.