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

Importante

Esta funcionalidad actualmente está en su versión preliminar. En Términos de uso complementarios para las versiones preliminares de Microsoft Azure se 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 que todavía no se han publicado con disponibilidad general. Para obtener información sobre esta versión preliminar específica, vea Información de Azure HDInsight sobre la versión preliminar de AKS. Para plantear preguntas o sugerencias sobre la característica, envíe una solicitud en AskHDInsight con los detalles y síganos para obtener más actualizaciones en 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 de administración de configuración.

Nota:

Esos errores tendrán una razón que comienza con el prefijo "User.".

Ejemplo de error de configuración:

En la siguiente tabla 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 Perfil de configuración del servicio.
User.Configuration.TrinoError	El inicio del proceso 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.FileForbidden	No se permiten cambios en algunos archivos de configuración de Trino.
User.Configuration.ParameterForbidden	No se permiten cambios en algunos parámetros de configuración de Trino.
User.Configuration.InvalidComponent	Componente de servicio no válido especificado. Para obtener más información, consulte Perfil de configuración del servicio.
User.Configuration.MiscFile.InvalidName	fileName misceláneo no válido. Para obtener más información, consulte archivos misceláneos.
User.Configuration.MiscFile.InvalidPath	La ruta del archivo misceláneo es demasiado larga.
User.Configuration.MiscFile.NotFound	Se encontró la etiqueta MISC sin el archivo correspondiente en la configuración de archivos misceláneos. Para obtener más información, consulte archivos misceláneos.
User.Configuration.MiscFile.DuplicateName	Se ha encontrado un valor de fileName duplicado en la sección de configuración de Archivos misceláneos.
User.Configuration.MiscFile.DuplicatePath	Se ha encontrado un valor de ruta de acceso duplicado en la sección de configuración de Archivos misceláneos.
User.Configuration.FormatError	Configuración del servicio con formato incorrecto, propiedades de contenido y valores usados en secciones incorrectas. Para obtener más información, consulte Perfil de configuración del servicio.
User.Configuration.HiveMetastore.MultiplePasswords	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 el catálogo catalogOptions.hive. Especifique una de las dos propiedades metastoreDbConnectionPasswordSecret o metastoreDbConnectionPassword.
User.Secrets.Error	Secretos o permisos mal configurados en Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	Falta el URI de Azure Key Vault en secretsProfile.
User.Secrets.KeyVaultUriRequired	Falta el URI de Azure Key Vault en secretsProfile.
User.Secrets.DuplicateReferenceName	ReferenceName duplicado encontrado en secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	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.
User.Secrets.NotFound	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 complemento duplicado usado en el usuario de configuración del clúster PluginsSpec.
User.Plugins.DuplicatePath	Ruta de acceso del complemento duplicada que se usa en el usuario de configuración del clúster PluginsSpec.
User.Plugins.InvalidPath	URI de almacenamiento con formato incorrecto para un complemento.
User.Plugins.PathNotFound	Ruta de acceso especificada para un complemento que no se encuentra en la cuenta de almacenamiento.
User.Telemetry.InvalidStoragePath	URI de almacenamiento con formato incorrecto en userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Catálogo de Hive inexistente especificado como destino para tablas de telemetría en userTelemetrySpec.
User.CatalogOptions.HiveCatalogNotFound	No se encuentra el catálogo de Hive en los catálogos de Trino Perfil de configuración del servicio para una configuración de catalogOptions.hive determinada. 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 una razón que empieza por el prefijo "System.". En tales casos, realice los siguientes pasos:

1. Recopile la siguiente información:
   1. Solicitud de Azure CorrelationId. Se puede encontrar en el área de notificación; o en el 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 de información general del clúster.
   3. Mensaje de error detallado.
2. Póngase en contacto con Equipo de soporte técnico con esta información.

Código de error	Descripción
System.DependencyFailure	Error en uno de los componentes del clúster.