Risolvere i problemi relativi alla configurazione del cluster

Nota

Azure HDInsight su AKS verrà ritirato il 31 gennaio 2025. Prima del 31 gennaio 2025, sarà necessario eseguire la migrazione dei carichi di lavoro a Microsoft Fabric o a un prodotto Azure equivalente per evitare interruzioni improvvise dei carichi di lavoro. I cluster rimanenti nella sottoscrizione verranno arrestati e rimossi dall’host.

Solo il supporto di base sarà disponibile fino alla data di ritiro.

Importante

Questa funzionalità è attualmente disponibile solo in anteprima. Le Condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure includono termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale. Per informazioni su questa anteprima specifica, vedere Informazioni sull'anteprima di Azure HDInsight nel servizio Azure Kubernetes. Per domande o suggerimenti sulle funzionalità, inviare una richiesta in AskHDInsight con i dettagli e seguire Microsoft per altri aggiornamenti nella 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 di Resource Manager o nell'input nel portale di Azure, ad esempio, nella pagina gestione della configurazione.

Nota

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

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 errore	Descrizione
User.TrinoError	L'avvio del processo Trino ha esito negativo con 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 trino nel Profilo di configurazione del servizio.
User.Configuration.FileForbidden	Le modifiche apportate ad alcuni file di configurazione trino non sono consentite.
User.Configuration.ParameterForbidden	Le modifiche apportate ad alcuni parametri di configurazione trino non sono consentite.
User.Configuration.InvalidComponent	Componente del servizio non valido specificato. Per altre informazioni, vedere Profilo di configurazione del servizio.
User.Configuration.MiscFile.InvalidName	FileName esterno non valido. Per altre informazioni, vedere File esterni.
User.Configuration.MiscFile.InvalidPath	Il percorso del file esterno troppo lungo.
User.Configuration.MiscFile.NotFound	Trovato il tag MISC senza il file corrispondente nella configurazione di file esterni. Per altre informazioni, vedere File esterni.
User.Configuration.MiscFile.DuplicateName	Valore fileName esterno duplicato trovato nella sezione configurazione File esterni.
User.Configuration.MiscFile.DuplicatePath	Valore del percorso duplicato trovato nella sezione configurazione File esterni.
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.
User.Configuration.HiveMetastore.MultiplePasswords	Più password specificate nel catalogo catalogOptions.hive. Specificare una delle due proprietà metastoreDbConnectionPasswordSecret o metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PasswordRequired	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	ReferenceName duplicato trovato in secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	Lo stesso oggetto/versione Key Vault usato più volte come riferimenti diversi nell'elenco dei segreti in secretsProfile.
User.Secrets.NotSpecified	Trovato il tag SECRET_REF senza l'oggetto segreto corrispondente in secretsProfile.
User.Secrets.NotFound	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 usato nella configurazione del cluster userPluginsSpec.
User.Plugins.InvalidPath	URI di archiviazione non valido per un plug-in.
User.Plugins.PathNotFound	Percorso specificato per un plug-in non trovato nell'account di archiviazione.
User.Telemetry.InvalidStoragePath	URI di archiviazione non valido in userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Catalogo Hive inesistente specificato come destinazione per le tabelle di telemetria in userTelemetrySpec.
User.CatalogOptions.HiveCatalogNotFound	Catalogo Hive non trovato nei cataloghi trino Profilo di configurazione del servizio per una determinata configurazione catalogOptions.hive. Per altre informazioni, vedere Metastore Hive.

Errori di sistema

Alcuni degli errori possono verificarsi a causa di condizioni dell'ambiente ed essere temporanei. Questi errori hanno un motivo che inizia con "System" come prefisso. In questi casi, provare i passaggi seguenti:

1. Raccogliere le informazioni seguenti:
   1. CorrelationId della richiesta di Azure. Può essere trovato nell'area Notifiche o in Gruppo di risorse in cui si trova il cluster, nella pagina Distribuzioni o 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 errore	Descrizione
System.DependencyFailure	Errore in uno dei componenti del cluster.