Problembehandlung der Clusterkonfiguration

Wichtig

Azure HDInsight auf AKS wurde am 31. Januar 2025 eingestellt. Erfahren Sie mehr mit dieser Ankündigung.

Sie müssen Ihre Workloads zu Microsoft Fabric oder ein gleichwertiges Azure-Produkt migrieren, um eine abrupte Beendigung Ihrer Workloads zu vermeiden.

Wichtig

Dieses Feature befindet sich derzeit in der Vorschau. Die zusätzlichen Nutzungsbedingungen für Microsoft Azure Previews weitere rechtliche Bestimmungen enthalten, die für Azure-Features gelten, die in der Betaversion, in der Vorschau oder auf andere Weise noch nicht in die allgemeine Verfügbarkeit veröffentlicht werden. Informationen zu dieser spezifischen Vorschau finden Sie unter Azure HDInsight auf AKS-Vorschauinformationen. Für Fragen oder Funktionsvorschläge geben Sie bitte eine Anfrage auf AskHDInsight an und geben Sie die Details an. Folgen Sie uns, um weitere Updates zur Azure HDInsight Communityzu erhalten.

Falsche Clusterkonfiguration kann zu Bereitstellungsfehlern führen. In der Regel treten diese Fehler auf, wenn eine falsche Konfiguration in der ARM-Vorlage oder in der Eingabe im Azure-Portal erfolgt, beispielsweise auf der Seite für Konfigurationsverwaltung.

Anmerkung

Diese Fehler haben Gründe, die mit dem Präfix "Benutzer." beginnen.

Beispielkonfigurationsfehler:

Die folgende Tabelle enthält Fehlercodes und deren Beschreibung, um häufige Fehler zu diagnostizieren und zu beheben.

Konfigurationsfehler

Fehlercode	Beschreibung
Benutzer.TrinoFehler	Der Trino-Prozessstart schlägt mit generischem Fehler fehl. Überprüfen Sie Trino-spezifische Konfigurationsdateien im Dienstkonfigurationsprofil .
Benutzer.Konfiguration.TrinoError	Der Trino-Prozessstart schlägt mit anwendungskonfigurationsfehlern fehl. Überprüfen Sie trinospezifische Konfigurationsdateien in Dienstkonfigurationsprofil.
Benutzer.Konfiguration.DateiVerboten	Änderungen an einigen Trinokonfigurationsdateien sind nicht zulässig.
Benutzer.Konfiguration.ParameterVerboten	Änderungen an einigen Trinokonfigurationsparametern sind nicht zulässig.
Benutzer.Konfiguration.UngültigeKomponente	Ungültige Dienstkomponente angegeben. Weitere Informationen finden Sie unter Dienstkonfigurationsprofil.
Ungültiger Dateiname in Benutzerkonfiguration	Ungültiger sonstiger Dateiname. Weitere Informationen finden Sie unter Verschiedene Dateien.
User.Configuration.VerschiedeneDatei.UngültigerPfad	Verschiedene Dateipfade sind zu lang.
Benutzer.Konfiguration.VerschiedeneDatei.NichtGefunden	MisC-Tag ohne entsprechende Datei in der Konfiguration verschiedener Dateien gefunden. Weitere Informationen finden Sie unter Verschiedene Dateien.
Benutzer.Konfiguration.VerschiedeneDateien.DoppelterName	Doppelter Dateiname-Wert im Konfigurationsabschnitt Sonstige Dateien gefunden.
User.Configuration.MiscFile.DuplicatePath	Doppelter Pfadwert im Konfigurationsabschnitt Sonstige Dateien gefunden.
Benutzer.Konfiguration.Formatfehler	Falsch formatierte Dienstkonfiguration, Inhalts-/Werteeigenschaften, die in falschen Abschnitten verwendet werden. Weitere Informationen finden Sie unter Dienstkonfigurationsprofil.
User.Configuration.HiveMetastore.MultiplePasswords	Mehrere Kennwörter, die im catalogOptions.hive-Katalog angegeben sind. Geben Sie eine von zwei Eigenschaften entweder metastoreDbConnectionPasswordSecret oder metastoreDbConnectionPassword an.
Benutzereinstellung.HiveMetastore.PasswortErforderlich	Kennwort erforderlich für catalogOptions.hive-Katalog. Geben Sie eine von zwei Eigenschaften entweder metastoreDbConnectionPasswordSecret oder metastoreDbConnectionPassword an.
Benutzer.Geheimnisse.Fehler	Falsch konfigurierte geheime Schlüssel oder Berechtigungen in Azure KeyVault.
Benutzer.Geheimnisse.UngültigerKeyVaultUri	Fehlender Azure Key Vault-URI in "secretsProfile".
User.Secrets.KeyVaultUriRequired	Fehlender Azure Key Vault-URI in "secretsProfile".
User.Secrets.DuplicateReferenceName	Doppelter Referenzname wurde in secretsProfile gefunden.
Benutzer.Geheimnisse.KeyVaultObjektMehrfachVerwendet	Dasselbe Schlüsseltresorobjekt/dieselbe Version wird mehrmals als verschiedene Referenzen in der Liste der geheimen Schlüssel in secretsProfile verwendet.
User.Geheimnisse.NichtAngegeben	Es wurde SECRET_REF Tag ohne entsprechendes geheimes Objekt in secretsProfile gefunden.
Benutzer.Geheimnisse.NichtGefunden	Angegebenes Key Vault-Objekt in "secretsProfile" wurde in KeyVault nicht gefunden. Überprüfen Sie den Namen, den Typ und die Version des Objekts.
Benutzer.Plugins.Fehler	Falsch konfigurierte Plug-Ins oder Berechtigungen im Speicherkonto.
User.Plugins.DuplicateName	Doppelter Plug-In-Name, der in der Clusterkonfiguration userPluginsSpec verwendet wird.
User.Plugins.DuplicatePath	Doppelter Plug-In-Pfad, der in der Clusterkonfiguration userPluginsSpec verwendet wird.
User.Plugins.InvalidPath	Falsch formatierter Speicher-URI für ein Plug-In.
User.Plugins.PathNotFound	Der angegebene Pfad für ein Plug-In wurde im Speicherkonto nicht gefunden.
Benutzer.Telemetrie.UngültigerSpeicherpfad	Falsch formatierter Speicher-URI in userTelemetrySpec.
Benutzer.Telemetrie.HiveKatalogNichtGefunden	Nicht vorhandener Hive-Katalog, der als Ziel für Telemetrietabellen in userTelemetrySpec angegeben wurde.
User.CatalogOptions.HiveCatalogNotFound	Der Hive-Katalog wurde in den Trino-Katalogen , Dienstkonfigurationsprofil, für eine gegebene catalogOptions.hive-Konfiguration nicht gefunden. Weitere Informationen finden Sie unter „Hive Metastore“.

Systemfehler

Einige der Fehler können aufgrund von Umgebungsbedingungen auftreten und vorübergehend sein. Diese Fehler haben grund, mit "System" als Präfix zu beginnen. Probieren Sie in solchen Fällen die folgenden Schritte aus:

1. Sammeln Sie die folgenden Informationen:
   1. Azure request CorrelationId. Sie befindet sich entweder im Bereich "Benachrichtigungen", unter "Ressourcengruppe", in der sich der Cluster befindet, auf der Seite "Bereitstellungen" oder in der Ausgabe des az-Befehls.
   2. DeploymentId. Sie finden Sie auf der Seite "Clusterübersicht".
   3. Detaillierte Fehlermeldung.
2. Wenden Sie sich mit diesen Informationen an das Supportteam.

Fehlercode	Beschreibung
System.Abhängigkeitsfehler	Fehler in einer der Clusterkomponenten.