Solucionar problemas de configuração de cluster

Importante

O Azure HDInsight no AKS foi desativado em 31 de janeiro de 2025. Saiba mais com este anúncio.

Você precisa migrar suas cargas de trabalho para Microsoft Fabric ou um produto equivalente do Azure para evitar o encerramento abrupto de suas cargas de trabalho.

Importante

Esta funcionalidade está atualmente em pré-visualização. Os Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure incluem mais termos legais que se aplicam a funcionalidades do Azure que estão em versão beta, em pré-visualização ou ainda não distribuídas para disponibilidade geral. Para obter informações sobre esta visualização específica, consulte as informações de visualização do Azure HDInsight sobre AKS . Para perguntas ou sugestões de funcionalidades, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para mais atualizações na Azure HDInsight Community.

A configuração incorreta do cluster pode levar a erros de implantação. Normalmente, esses erros ocorrem quando a configuração incorreta é fornecida no modelo ARM ou na entrada no portal do Azure, por exemplo, na página Gerenciamento de configuração.

Observação

Esses erros terão razão começando com o prefixo "Usuário".

Exemplo de erro de configuração:

A tabela a seguir fornece códigos de erro e sua descrição para ajudar a diagnosticar e corrigir erros comuns.

Erros de configuração

Código de erro	Descrição
User.TrinoError	A inicialização do processo Trino falha com erro genérico. Verifique os arquivos de configuração específicos do trino no perfil de configuração do serviço .
Utilizador.Configuração.TrinoErro	A inicialização do processo Trino falha com erro de configuração do aplicativo. Verifique os arquivos de configuração específicos do trino no perfil de configuração do serviço .
Utilizador.Configuração.FicheiroProibido	Alterações em alguns arquivos de configuração do trino não são permitidas.
Utilizador.Configuração.ParâmetroProibido	Alterações em alguns parâmetros de configuração do trino não são permitidas.
Configuração do Utilizador: Componente Inválido	Componente de serviço inválido especificado. Para mais informações, consulte o perfil de configuração do serviço .
User.Configuration.MiscFile.InvalidName	Nome de ficheiro diverso inválido. Para obter mais informações, consulte Arquivos diversos.
User.Configuration.MiscFile.InvalidPath	O caminho de arquivo diverso é muito longo.
Ficheiro de configuração de utilizador não encontrado.	Encontrada tag MISC sem arquivo correspondente na configuração de arquivos diversos. Para obter mais informações, consulte Arquivos diversos.
Utilizador.Configuração.FicheiroDiverso.NomeDuplicado	Valor fileName duplicado encontrado em seção Arquivos diversos configuração.
User.Configuração.FicheiroDiverso.CaminhoDuplicado	Valor de caminho duplicado encontrado na seção Arquivos diversos de configuração.
User.Configuration.FormatError	Configuração de serviço malformada, propriedades de conteúdo/valores usadas em seções erradas. Para mais informações, consulte o perfil de configuração do serviço .
Configuração do Utilizador.HiveMetastore.Senhas Múltiplas	Várias senhas especificadas no catálogo catalogOptions.hive. Especifique uma das duas propriedades metastoreDbConnectionPasswordSecret ou metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PalavraPasseObrigatória	Senha necessária para catalogOptions.hive catalog. Especifique uma das duas propriedades metastoreDbConnectionPasswordSecret ou metastoreDbConnectionPassword.
User.Secrets.Error	Segredos ou permissões mal configurados no Azure KeyVault.
User.Secrets.InvalidKeyVaultUri	Falta o URI do Azure Key Vault no secretsProfile.
Chave do KeyVault do Utilizador é necessária	Missing Azure Key Vault URI em secretsProfile.
User.Secrets.DuplicateReferenceName	Nome de referência duplicado encontrado em secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	O mesmo objeto/versão do cofre de chaves usado várias vezes como referências diferentes na lista de segredos em secretsProfile.
Utilizador.Segredos.NãoEspecificado	Encontrada a etiqueta SECRET_REF sem um objeto secreto correspondente em secretsProfile.
Utilizador.Secrets.NotFound	Objeto Key Vault especificado em secretsProfile não encontrado no KeyVault. Verifique o nome, o tipo e a versão do objeto.
User.Plugins.Error	Plugins ou permissões mal configurados na conta de armazenamento.
User.Plugins.NomeDuplicado	Nome de plug-in duplicado usado na configuração do cluster userPluginsSpec.
User.Plugins.DuplicatePath	Caminho de plug-in duplicado usado na configuração do cluster "userPluginsSpec".
User.Plugins.InvalidPath	URI de armazenamento malformado para um plugin.
User.Plugins.PathNotFound	Caminho especificado para um plug-in não encontrado na conta de armazenamento.
User.Telemetria.CaminhoDeArmazenamentoInválido	URI de armazenamento malformado em userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Catálogo Hive inexistente especificado como alvo para as tabelas de telemetria em userTelemetrySpec.
Catálogo de Hive não encontrado	Catálogo do Hive não encontrado nos catálogos do Trino Perfil de configuração do serviço para uma determinada configuração de catalogOptions.hive. Para obter mais informações, consulte metastore do Hive.

Erros do sistema

Alguns dos erros podem ocorrer devido às condições do ambiente e ser transitórios. Esses erros têm razão começando com "System." como prefixo. Nesses casos, tente as seguintes etapas:

1. Colete as seguintes informações:
   1. CorrelationId da solicitação do Azure. Pode ser encontrado na área de Notificações, no Grupo de Recursos onde o cluster está localizado, na página de Implantações, ou nos resultados do comando az.
   2. DeploymentId. Ele pode ser encontrado na página Visão Geral do Cluster.
   3. Mensagem de erro detalhada.
2. Entre em contato com a equipe de suporte com essas informações.

Código de erro	Descrição
Sistema.FalhaDeDependência	Falha em um dos componentes do cluster.