Solución de problemas de configuración del clúster

Importante

Azure HDInsight en AKS se retiró el 31 de enero de 2025. Obtenga más información con este anuncio.

Debe migrar las cargas de trabajo a microsoft Fabric o un producto equivalente de Azure para evitar la terminación repentina de las cargas de trabajo.

Importante

Esta característica está actualmente en versión preliminar. Los Términos de uso complementarios para las versiones preliminares de Microsoft Azure incluyen más términos legales que se aplican a las características de Azure que se encuentran en versión beta, en versión preliminar o, de lo contrario, aún no se han publicado en disponibilidad general. Para obtener información sobre esta versión preliminar específica, consulte información de la versión preliminar de Azure HDInsight en AKS. Para preguntas o sugerencias de características, envíe una solicitud en AskHDInsight con los detalles y síganos para obtener más actualizaciones sobre Comunidad de Azure HDInsight.

La configuración incorrecta del clúster puede provocar errores de implementación. Normalmente, esos errores se producen cuando se proporciona una configuración incorrecta en la plantilla de ARM o la entrada en Azure Portal, por ejemplo, en la página Administración de configuración.

Nota

Esos errores tendrán razón a partir del prefijo "Usuario".

Error de configuración de ejemplo:

En la tabla siguiente se proporcionan códigos de error y su descripción para ayudar a diagnosticar y corregir errores comunes.

Errores de configuración

Código de error	Descripción
User.TrinoError	El inicio del proceso de Trino produce un error genérico. Compruebe los archivos de configuración específicos de Trino en el perfil de configuración del servicio .
Usuario.Configuración.TrinoError	El proceso de arranque de Trino produce un error de configuración de la aplicación. Compruebe los archivos de configuración específicos de trino en perfil de configuración del servicio.
User.Configuration.ArchivoProhibido	No se permiten cambios en algunos archivos de configuración de trino.
Usuario.Configuración.ParámetroProhibido	No se permiten cambios en algunos parámetros de configuración de Trino.
Usuario.Configuración.ComponenteInválido	Componente de servicio no válido especificado. Para obtener más información, consulte el perfil de configuración del servicio .
Usuario.Configuración.MiscFile.NombreInválido	Nombre de archivo misceláneo no válido. Para obtener más información, consulte Archivos Varios.
User.Configuration.MiscFile.InvalidPath	La ruta de acceso del archivo misceláneo es demasiado larga.
Usuario.Configuración.ArchivoDiverso.NoEncontrado	Se encontró la etiqueta MISC sin el archivo correspondiente en la configuración de archivos misceláneos. Para obtener más información, vea archivos varios.
Configuración.Usuario.ArchivoVario.NombreDuplicado	Se ha encontrado un valor duplicado de fileName en la sección de configuración de archivos varios .
User.Configuration.MiscFile.DuplicatePath	Se encontró valor de ruta duplicado en la sección de configuración de archivos varios .
User.Configuration.FormatError	Configuración del servicio con formato incorrecto, propiedades de contenido y valores usadas en secciones incorrectas. Para obtener más información, consulte Perfil de Configuración del Servicio.
Usuario.Configuración.HiveMetastore.ContraseñasMúltiples	Varias contraseñas especificadas en el catálogo catalogOptions.hive. Especifique una de las dos propiedades metastoreDbConnectionPasswordSecret o metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PasswordRequired	Contraseña necesaria para catalogOptions.hive catalog. Especifique una de las dos propiedades metastoreDbConnectionPasswordSecret o metastoreDbConnectionPassword.
Error de secretos de usuario	Secretos o permisos mal configurados en Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	Falta el URI de Azure Key Vault en secretsProfile.
Usuario.Secretos.KeyVaultUriRequerido	Falta el URI de Azure Key Vault en secretsProfile.
User.Secrets.DuplicateReferenceName	Se encontró un nombre de referencia duplicado en secretsProfile.
Usuario.Secretos.ObjetoDeKeyVaultUsadoMultiplesVeces	El mismo objeto o versión del almacén de claves se usa varias veces como referencias diferentes en la lista de secretos de secretsProfile.
User.Secrets.NotSpecified	Se encontró la etiqueta SECRET_REF sin el objeto secreto correspondiente en secretsProfile.
Usuario.Secretos.NoEncontrado	El objeto Key Vault especificado en secretsProfile no se encuentra en KeyVault. Compruebe el nombre, el tipo y la versión del objeto.
User.Plugins.Error	Complementos o permisos mal configurados en la cuenta de almacenamiento.
User.Plugins.DuplicateName	Nombre de plugin duplicado usado en la configuración del clúster userPluginsSpec.
User.Plugins.DuplicatePath	Ruta del complemento duplicada utilizada en la configuración del clúster userPluginsSpec.
User.Plugins.InvalidPath	URI de almacenamiento con formato incorrecto para un complemento.
User.Plugins.PathNotFound	La ruta especificada para un complemento no se encuentra en la cuenta de almacenamiento.
Rastro de usuario.Telemetría.RutaDeAlmacenamientoInválida	URI de almacenamiento con formato incorrecto en userTelemetrySpec.
Usuario.Telemetría.HiveCatalogoNoEncontrado	Catálogo de Hive inexistente especificado como destino para tablas de telemetría en userTelemetrySpec.
Usuario.OpcionesDeCatálogo.CatálogoDeHiveNoEncontrado	No se encuentra el catálogo de Hive en los catálogos de Trino perfil de configuración del servicio para una configuración determinada de catalogOptions.hive. Para obtener más información, consulte metastore de Hive.

Errores del sistema

Algunos de los errores pueden producirse debido a las condiciones del entorno y ser transitorios. Estos errores tienen razón a partir de "System". como prefijo. En tales casos, pruebe los pasos siguientes:

1. Recopile la siguiente información:
   1. ID de correlación de solicitud de Azure. Se puede encontrar en el área Notificaciones; o en Grupo de recursos donde se encuentra el clúster, en la página Implementaciones; o en la salida del comando az.
   2. DeploymentId. Puede encontrarse en la página Información general del clúster.
   3. Mensaje de error detallado.
2. Póngase en contacto con el equipo de soporte técnico con esta información.

Código de error	Descripción
System.DependencyFailure (Fallo en la Dependencia del Sistema)	Error en uno de los componentes del clúster.