Risolvere i problemi di configurazione del cluster

Importante

Azure HDInsight su AKS è stato ritirato il 31 gennaio 2025. Scopri di più con questo annuncio.

È necessario eseguire la migrazione dei carichi di lavoro a Microsoft Fabric o a un prodotto Azure equivalente per evitare la chiusura brusca dei carichi di lavoro.

Importante

Questa funzionalità è attualmente in anteprima. Le condizioni supplementari per l'utilizzo per le anteprime di Microsoft Azure includono termini legali più validi applicabili alle funzionalità di Azure in versione beta, in anteprima o altrimenti non ancora rilasciate nella disponibilità generale. Per informazioni su questa anteprima specifica, vedere informazioni dell'anteprima di Azure HDInsight su AKS. Per domande o suggerimenti sulle funzionalità, inviare una richiesta su AskHDInsight con i dettagli e seguireci per altri aggiornamenti sulla Community di Azure HDInsight.

La configurazione del cluster non corretta può causare errori di distribuzione. In genere questi errori si verificano quando viene fornita una configurazione non corretta nel modello ARM o nell'input nel portale di Azure, ad esempio nella pagina Gestione configurazione.

Nota

Questi errori avranno motivo a partire dal prefisso "User".

Esempio di errore di configurazione:

La tabella seguente fornisce codici di errore e la relativa descrizione per diagnosticare e correggere gli errori comuni.

Errori di configurazione

Codice di errore	Descrizione
User.TrinoError	L'avvio del processo Trino non riesce a causa di un errore generico. Verificare i file di configurazione specifici trino nel profilo di configurazione del servizio .
User.Configuration.TrinoError	L'avvio del processo Trino ha esito negativo e viene visualizzato un errore di configurazione dell'applicazione. Verificare i file di configurazione specifici di Trino nel profilo di configurazione del servizio .
Configurazione.Utente.FileProibito	Le modifiche apportate ad alcuni file di configurazione trino non sono consentite.
Utente.Configurazione.ParametroProibito	Le modifiche apportate ad alcuni parametri di configurazione Trino non sono consentite.
Utente.Configurazione.ComponenteNonValido	Specificato componente del servizio non valido. Per altre informazioni, vedere profilo di configurazione del servizio .
User.Configurazione.FileVarie.NomeNonValido	Nome file vario non valido. Per maggiori informazioni, vedere file vari.
User.Configuration.MiscFile.InvalidPath	Il percorso del file variato è troppo lungo.
User.Configuration.MiscFile.NotFound	Trovato il tag MISC senza il file corrispondente nella configurazione di file vari. Per ulteriori informazioni, consultare file vari.
NomeDoppio.User.Configurazione.FileVarie	Valore duplicato di fileName trovato nella sezione di configurazione File vari.
User.Configuration.MiscFile.DuplicatePath	Valore del percorso duplicato trovato nella sezione di configurazione file vari.
User.Configuration.FormatError	Configurazione del servizio in formato non valido, proprietà di contenuto/valori usate nelle sezioni errate. Per altre informazioni, vedere profilo di configurazione del servizio .
Configurazione.Utente.HiveMetastore.PasswordMultiple	Più password specificate nel catalogo catalogOptions.hive. Specificare una delle due proprietà metastoreDbConnectionPasswordSecret o metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PasswordRichiesta	Password necessaria per il catalogo catalogOptions.hive. Specificare una delle due proprietà metastoreDbConnectionPasswordSecret o metastoreDbConnectionPassword.
User.Secrets.Error	Segreti o autorizzazioni configurati in modo errato in Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	URI di Azure Key Vault mancante in secretsProfile.
User.Secrets.KeyVaultUriRequired	URI di Azure Key Vault mancante in secretsProfile.
User.Secrets.DuplicateReferenceName	Nome di riferimento duplicato trovato in secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	Lo stesso oggetto/versione dell'insieme di credenziali utilizzato più volte come riferimento diverso nell'elenco dei segreti in secretsProfile.
User.Secrets.NotSpecified	Trovato SECRET_REF tag senza l'oggetto segreto corrispondente in secretsProfile.
User.Segreti.NonTrovato	L'oggetto Key Vault specificato in secretsProfile non è stato trovato in KeyVault. Verificare il nome, il tipo e la versione dell'oggetto.
User.Plugins.Error	Plug-in o autorizzazioni non configurati correttamente nell'account di archiviazione.
User.Plugins.DuplicateName	Nome del plug-in duplicato usato nella configurazione del cluster userPluginsSpec.
User.Plugins.DuplicatePath	Percorso del plug-in duplicato utilizzato nella configurazione del cluster userPluginsSpec.
Percorso non valido dei plugin utente	URI di archiviazione non valido per un plug-in.
User.Plugin.PercorsoNonTrovato	Percorso specificato per un plug-in non trovato nell'account di archiviazione.
User.Telemetry.PercorsoDiArchiviazioneNonValido	URI di archiviazione malformato in "userTelemetrySpec".
User.Telemetry.HiveCatalogNotFound	Catalogo Hive inesistente specificato come destinazione per le tabelle di telemetria in userTelemetrySpec.
OpzioniCatalogo.Utente.CatalogoHiveNonTrovato	Catalogo Hive non trovato nei cataloghi di Trino profilo di configurazione del servizio per una configurazione specifica di catalogOptions.hive. Per altre informazioni, vedere metastore Hive.

Errori di sistema

Alcuni degli errori possono verificarsi a causa di condizioni di ambiente ed essere temporanei. Questi errori hanno motivo a partire da "System". come prefisso. In questi casi, provare i passaggi seguenti:

1. Raccogliere le informazioni seguenti:
   1. La richiesta di Azure CorrelationId. Può essere trovato nell'area Notifiche; o in Gruppo di risorse in cui si trova il cluster, nella pagina Distribuzioni; oppure in az command output.
   2. DeploymentId. È disponibile nella pagina Panoramica del cluster.
   3. Messaggio di errore dettagliato.
2. Contattare il team di supporto con queste informazioni.

Codice di errore	Descrizione
Errore di Dipendenza di Sistema	Errore in uno dei componenti del cluster.