Felsöka klusterkonfiguration

Viktig

Azure HDInsight på AKS drogs tillbaka den 31 januari 2025. Läs mer genom det här meddelandet.

Du måste migrera dina arbetsbelastningar till Microsoft Fabric- eller en motsvarande Azure-produkt för att undvika plötsliga uppsägningar av dina arbetsbelastningar.

Viktig

Den här funktionen är för närvarande i förhandsversion. De kompletterande användningsvillkoren för Förhandsversioner av Microsoft Azure innehåller fler juridiska villkor som gäller för Azure-funktioner som är i betaversion, förhandsversion eller på annat sätt ännu inte är släppta i allmän tillgänglighet. Information om den här specifika förhandsversionen finns i Azure HDInsight på AKS-förhandsversionsinformation. För frågor eller funktionsförslag, skicka en begäran på AskHDInsight med detaljerna och följ oss för fler uppdateringar om Azure HDInsight Community.

Felaktig klusterkonfiguration kan leda till distributionsfel. Dessa fel uppstår vanligtvis när felaktig konfiguration har angetts i ARM-mallen eller information har angetts i Azure-portalen, såsom på sidan Konfigurationshantering.

Notera

Dessa fel har anledning att börja med prefixet "Användare".

Exempel på konfigurationsfel:

Följande tabell innehåller felkoder och deras beskrivning för att diagnostisera och åtgärda vanliga fel.

Konfigurationsfel

Felkod	Beskrivning
User.TrinoError	Trino-processens start misslyckas med ett allmänt fel. Verifiera trino-specifika konfigurationsfiler i tjänstkonfigurationsprofil.
User.Configuration.TrinoError	Trino-processens start misslyckas med programkonfigurationsfel. Verifiera Trino-specifika konfigurationsfiler i tjänstkonfigurationsprofil.
Användarkonfiguration.FilFörbjuden	Ändringar i vissa trinokonfigurationsfiler tillåts inte.
Användare.Konfiguration.ParameterFörbjuden	Ändringar i vissa trinokonfigurationsparametrar tillåts inte.
Användare.Konfiguration.OgiltigKomponent	Ogiltig tjänstkomponent har angetts. Mer information finns i Tjänstkonfigurationsprofil.
Användare.Configuration.MiscFile.OgiltigtNamn	Ogiltigt övrigt filnamn. Mer information finns i Diverse filer.
User.Configuration.MiscFile.InvalidPath	Den övriga filsökvägen är för lång.
Användare.Konfiguration.MiscFil.InteFunnen	Hittade MISC-taggen utan motsvarande fil i konfigurationen av diverse filer. Mer information finns i Diverse filer.
User.Configuration.MiscFile.DuplicateName	Duplicera fileName-värdet som finns i Diverse filer konfigurationsavsnittet.
User.Configuration.MiscFile.DuplicatePath	Duplicerat sökvägs värde hittades i Diverse filer konfigurationsavsnittet.
Användare.Konfiguration.FormatFel	Felaktig tjänstkonfiguration, egenskaper för innehåll/värden som används i fel avsnitt. Mer information finns i Tjänstkonfigurationsprofil.
User.Configuration.HiveMetastore.FleraLösenord	Flera lösenord angivna i katalogOptions.hive-katalogen. Ange en av två egenskaper, antingen metastoreDbConnectionPasswordSecret eller metastoreDbConnectionPassword.
Användare.Konfiguration.HiveMetastore.LösenordKrävs	Lösenord krävs för catalogOptions.hive-katalogen. Ange en av två egenskaper, antingen metastoreDbConnectionPasswordSecret eller metastoreDbConnectionPassword.
Användare.Hemligheter.Fel	Felkonfigurerade hemligheter eller behörigheter i Azure KeyVault.
Användare.Hemligheter.OgiltigNyckelValvUri	Azure Key Vault-URI saknas i secretsProfile.
User.Secrets.KeyVaultUriRequired	Azure Key Vault-URI saknas i secretsProfile.
User.Secrets.DuplicateReferenceName	Dubblettreferensnamn hittades i secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	Samma nyckelvalvsobjekt/-version används flera gånger som olika referenser i hemlighetslistan i secretsProfile.
User.Secrets.NotSpecified	Hittade SECRET_REF tagg utan motsvarande hemligt objekt i secretsProfile.
Användare.Hemligheter.InteHittad	Det gick inte att hitta det angivna Key Vault-objektet i secretsProfile i KeyVault. Kontrollera namn, typ och version av objektet.
User.Plugins.Error	Felkonfigurerade plugin-program eller behörigheter i lagringskontot.
Användare.Pluginer.DubblettNamn	Duplicerat pluginnamn används i klusterkonfigurationen userPluginsSpec.
User.Plugins.DuplicatePath	Duplicerad plugin-sökväg som används i klusterkonfigurationen userPluginsSpec.
User.Plugins.InvalidPath	Felaktig lagrings-URI för ett plugin-program.
User.Plugins.PathNotFound	Den angivna sökvägen för ett plugin-program hittades inte i lagringskontot.
Användare.Telemetri.OgiltigLagringssökväg	Felaktig lagrings-URI i userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Den obefintliga Hive-katalogen specificeras som mål för telemetritabeller i userTelemetrySpec.
Användare.Katalogalternativ.HiveKatalogEjFunnen	Hive-katalogen hittades inte i trinokataloger tjänstkonfigurationsprofil för en viss katalogOptions.hive-konfiguration. För mer information, se Hive metastore.

Systemfel

Vissa av felen kan inträffa på grund av miljöförhållanden och vara tillfälliga. Dessa fel har anledning att börja med "System" som prefix. I sådana fall kan du prova följande steg:

1. Samla in följande information:
   1. Korrelations-ID för Azure-begäran. Den finns antingen i området Meddelanden; eller under Resursgrupp där klustret finns, på sidan Distributioner; eller i az command output.
   2. Implementerings-ID. Den finns på sidan Klusteröversikt.
   3. Detaljerat felmeddelande.
2. Kontakta supportteamet med den här informationen.

Felkod	Beskrivning
System.DependencyFailure	Fel i någon av klusterkomponenterna.