Problembehandlung bei der Clusterkonfiguration

Hinweis

Azure HDInsight on AKS wird am 31. Januar 2025 eingestellt. Vor dem 31. Januar 2025 müssen Sie Ihre Workloads zu Microsoft Fabric oder einem gleichwertigen Azure-Produkt migrieren, um eine abruptes Beendigung Ihrer Workloads zu vermeiden. Die verbleibenden Cluster in Ihrem Abonnement werden beendet und vom Host entfernt.

Bis zum Einstellungsdatum ist nur grundlegende Unterstützung verfügbar.

Wichtig

Diese Funktion steht derzeit als Vorschau zur Verfügung. Die zusätzlichen Nutzungsbedingungen für Microsoft Azure-Vorschauen enthalten weitere rechtliche Bestimmungen, die für Azure-Features in Betaversionen, in Vorschauversionen oder anderen Versionen gelten, die noch nicht allgemein verfügbar gemacht wurden. Informationen zu dieser spezifischen Vorschau finden Sie unter Informationen zur Vorschau von Azure HDInsight on AKS. Bei Fragen oder Funktionsvorschlägen senden Sie eine Anfrage an AskHDInsight mit den entsprechenden Details, und folgen Sie uns für weitere Updates in der Azure HDInsight-Community.

Eine falsche Clusterkonfiguration kann zu Bereitstellungsfehlern führen. Diese Fehler treten in der Regel auf, wenn in einer ARM-Vorlage oder im Azure-Portal (beispielsweise auf der Seite Konfigurationsverwaltung) eine falsche Konfiguration angegeben wird.

Hinweis

Bei diesen Fehlern beginnt die Ursache mit dem Präfix „User“.

Beispielkonfigurationsfehler:

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

Konfigurationsfehler

Fehlercode	Beschreibung
User.TrinoError	Der Trino-Prozessstart schlägt mit generischem Fehler fehl. Überprüfen Sie die trinospezifische Konfigurationsdateien im Dienstkonfigurationsprofil.
User.Configuration.TrinoError	Der Trino-Prozessstart schlägt mit Anwendungskonfigurationsfehlern fehl. Überprüfen Sie die trinospezifische Konfigurationsdateien im Dienstkonfigurationsprofil.
User.Configuration.FileForbidden	Änderungen an einigen Trinokonfigurationsdateien sind nicht zulässig.
User.Configuration.ParameterForbidden	Änderungen an einigen Trinokonfigurationsparametern sind nicht zulässig.
User.Configuration.InvalidComponent	Ungültige Dienstkomponente angegeben. Weitere Informationen finden Sie unter Dienstkonfigurationsprofil.
User.Configuration.MiscFile.InvalidName	Ungültiger sonstiger Dateiname. Weitere Informationen finden Sie unter Sonstige Dateien.
User.Configuration.MiscFile.InvalidPath	Sonstige Dateipfade sind zu lang.
User.Configuration.MiscFile.NotFound	MISC-Tag ohne entsprechende Datei in der Konfiguration sonstiger Dateien gefunden. Weitere Informationen finden Sie unter Sonstige Dateien.
User.Configuration.MiscFile.DuplicateName	Doppelter Dateiname-Wert im Konfigurationsabschnitt Verschiedene Dateien.
User.Configuration.MiscFile.DuplicatePath	Doppelter Pfadwert im Konfigurationsabschnitt Sonstige Dateien.
User.Configuration.FormatError	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.
User.Configuration.HiveMetastore.PasswordRequired	Kennwort erforderlich für catalogOptions.hive-Katalog. Geben Sie eine von zwei Eigenschaften entweder metastoreDbConnectionPasswordSecret oder metastoreDbConnectionPassword an.
User.Secrets.Error	Falsch konfigurierte geheime Schlüssel oder Berechtigungen in Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	Fehlender Azure Key Vault-URI in secretsProfile.
User.Secrets.KeyVaultUriRequired	Fehlender Azure Key Vault-URI in secretsProfile.
User.Secrets.DuplicateReferenceName	Doppelter referenceName in secretsProfile gefunden.
User.Secrets.KeyVaultObjectUsedMultipleTimes	Dasselbe Schlüsseltresorobjekt/dieselbe Version wird mehrmals als unterschiedliche Verweise in der Liste geheimer Schlüssel in secretsProfile verwendet.
User.Secrets.NotSpecified	Das Tag SECRET_REF wurde ohne entsprechendes geheimes Objekt in secretsProfile gefunden.
User.Secrets.NotFound	Angegebenes Key Vault-Objekt in secretsProfile wurde in KeyVault nicht gefunden. Überprüfen Sie den Namen, den Typ und die Version des Objekts.
User.Plugins.Error	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.
User.Telemetry.InvalidStoragePath	Falsch formatierter Speicher-URI in userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Nicht vorhandener Hive-Katalog, der als Ziel für Telemetrietabellen in userTelemetrySpec angegeben wurde.
User.CatalogOptions.HiveCatalogNotFound	Der Strukturkatalog wurde in trino catalogs Service-Konfigurationsprofil für eine bestimmte catalogOptions.hive-Konfiguration nicht gefunden. Weitere Informationen finden Sie im Hive-Metaspeicher.

Systemfehler

Einige der Fehler können aufgrund von Umgebungsbedingungen auftreten und vorübergehend sein. Bei diesen Fehlern beginnt die Ursache mit dem Präfix „System“. Führen Sie in solchen Fällen die folgenden Schritte aus:

1. Stellen Sie die folgenden Informationen zusammen:
   1. CorrelationId der Azure-Anforderung. Sie befindet sich entweder im Bereich Benachrichtigungen; oder unter Ressourcengruppe, in der sich das Cluster befindet, auf der Seite Bereitstellungen; oder in der az-Befehlsausgabe.
   2. DeploymentId. Sie befindet sich auf der Seite „Clusterübersicht“.
   3. Detaillierte Fehlermeldung.
2. Wenden Sie sich mit diesen Informationen an das Supportteam.

Fehlercode	Beschreibung
System.DependencyFailure	Fehler in einer der Clusterkomponenten.