Solucionar problemas de configuração de cluster

Nota

Vamos desativar o Azure HDInsight no AKS em 31 de janeiro de 2025. Antes de 31 de janeiro de 2025, você precisará migrar suas cargas de trabalho para o Microsoft Fabric ou um produto equivalente do Azure para evitar o encerramento abrupto de suas cargas de trabalho. Os clusters restantes na sua subscrição serão interrompidos e removidos do anfitrião.

Apenas o apoio básico estará disponível até à data da reforma.

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 disponibilizadas para disponibilidade geral. Para obter informações sobre essa visualização específica, consulte Informações de visualização do Azure HDInsight no AKS. Para perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para obter mais atualizações na Comunidade do Azure HDInsight.

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.

Nota

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	Description
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.
User.Configuration.TrinoError	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.
User.Configuration.FileForbidden	Alterações em alguns arquivos de configuração do trino não são permitidas.
User.Configuration.ParameterForbidden	Alterações em alguns parâmetros de configuração do trino não são permitidas.
User.Configuration.InvalidComponent	Componente de serviço inválido especificado. Para obter mais informações, consulte Perfil de configuração do serviço.
User.Configuration.MiscFile.InvalidName	FileName diverso inválido. Para obter mais informações, consulte Arquivos diversos.
User.Configuration.MiscFile.InvalidPath	O caminho de arquivo diverso é muito longo.
User.Configuration.MiscFile.NotFound	Encontrada tag MISC sem arquivo correspondente na configuração de arquivos diversos. Para obter mais informações, consulte Arquivos diversos.
User.Configuration.MiscFile.DuplicateName	Valor fileName duplicado encontrado na seção Configuração de arquivos diversos.
User.Configuration.MiscFile.DuplicatePath	Valor de caminho duplicado encontrado na seção Configuração de arquivos diversos.
User.Configuration.FormatError	Configuração de serviço malformada, propriedades de conteúdo/valores usadas em seções erradas. Para obter mais informações, consulte Perfil de configuração do serviço.
User.Configuration.HiveMetastore.MultiplePasswords	Várias senhas especificadas no catálogo catalogOptions.hive. Especifique uma das duas propriedades metastoreDbConnectionPasswordSecret ou metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PasswordRequired	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	URI do Azure Key Vault ausente em secretsProfile.
User.Secrets.KeyVaultUriRequired	URI do Azure Key Vault ausente em secretsProfile.
User.Secrets.DuplicateReferenceName	Referência duplicadaNome 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.
User.Secrets.NotSpecified	Encontrado SECRET_REF tag sem o objeto secreto correspondente em secretsProfile.
Usuário.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.DuplicateName	Nome de plug-in duplicado usado na configuração do cluster userPluginsSpec.
User.Plugins.DuplicatePath	Caminho de plug-in duplicado usado na configuração de 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.Telemetry.InvalidStoragePath	URI de armazenamento malformado em userTelemetrySpec.
User.Telemetry.HiveCatalogNotFound	Catálogo do Hive inexistente especificado como destino para tabelas de telemetria em userTelemetrySpec.
User.CatalogOptions.HiveCatalogNotFound	Catálogo do Hive não encontrado em catálogos trinos Perfil de configuração de serviço para uma determinada configuração 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. Azure request CorrelationId. Pode ser encontrado na área de Notificações; ou em Grupo de Recursos onde o cluster está localizado, na página Implantações; ou na saída 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	Description
System.DependencyFailure	Falha em um dos componentes do cluster.