Solucionar problemas de configuração de cluster

Observação

Desativaremos o Microsoft Azure HDInsight no AKS em 31 de janeiro de 2025. Para evitar o encerramento abrupto das suas cargas de trabalho, você precisará migrá-las para o Microsoft Fabric ou para um produto equivalente do Azure antes de 31 de janeiro de 2025. Os clusters restantes em sua assinatura serão interrompidos e removidos do host.

Somente o suporte básico estará disponível até a data de desativação.

Importante

Esse recurso está atualmente na visualização. Os Termos de uso complementares para versões prévias do Microsoft Azure incluem mais termos legais que se aplicam aos recursos do Azure que estão em versão beta, em versão prévia ou ainda não lançados em disponibilidade geral. Para obter informações sobre essa versão prévia específica, confira Informações sobre a versão prévia do Azure HDInsight no AKS. Caso tenha perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para ver mais atualizações sobre a Comunidade do Azure HDInsight.

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

Observação

Esses erros começarão com o prefixo "User.".

Exemplo de erro de configuração:

A tabela a seguir fornece os códigos de erro e as descrições para ajudar a diagnosticar e corrigir os erros comuns.

Erros de configuração

Código do erro	Descrição
User.TrinoError	A inicialização de processo do Trino falha com erro genérico. Verifique os arquivos de configuração específicos do Trino no Perfil de configuração de serviço.
User.Configuration.TrinoError	A inicialização do processo do Trino falha com o erro de configuração do aplicativo. Verifique os arquivos de configuração específicos do Trino no Perfil de configuração de serviço.
User.Configuration.FileForbidden	Não são permitidas alterações em alguns arquivos de configuração do Trino.
User.Configuration.ParameterForbidden	Não são permitidas alterações em alguns parâmetros de configuração do Trino.
User.Configuration.InvalidComponent	Componente de serviço inválido especificado. Para obter mais informações, consulte Perfil de configuração de serviço.
User.Configuration.MiscFile.InvalidName	FileName diverso inválido. Para obter mais informações, consulte Arquivos diversos.
User.Configuration.MiscFile.InvalidPath	O caminho do arquivo diverso é muito longo.
User.Configuration.MiscFile.NotFound	Marca MISC encontrada sem o arquivo correspondente na configuração de arquivos diversos. Para obter mais informações, consulte Arquivos diversos.
User.Configuration.MiscFile.DuplicateName	Valor de fileName duplicado encontrado na seção de configuração Arquivos diversos.
User.Configuration.MiscFile.DuplicatePath	Valor de caminho duplicado encontrado na seção de configuração de Arquivos diversos.
User.Configuration.FormatError	Configuração de serviço malformada, propriedades de conteúdo/valores utilizadas em seções erradas. Para obter mais informações, consulte Perfil de configuração de serviço.
User.Configuration.HiveMetastore.MultiplePasswords	Múltiplas senhas especificadas no catálogo catalogOptions.hive. Especifique uma das duas propriedades metastoreDbConnectionPasswordSecret ou metastoreDbConnectionPassword.
User.Configuration.HiveMetastore.PasswordRequired	Senha obrigatória para o catálogo catalogOptions.hive. 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	referenceName duplicado encontrado em secretsProfile.
User.Secrets.KeyVaultObjectUsedMultipleTimes	O mesmo objeto/versão do Key Vault utilizado várias vezes como referências diferentes na lista de segredos em secretsProfile.
User.Secrets.NotSpecified	Marca SECRET_REF encontrada sem o objeto secreto correspondente em secretsProfile.
User.Secrets.NotFound	Objeto Key Vault especificado em secretsProfile não encontrado em KeyVault. Verifique o nome, o tipo e a versão do objeto.
User.Plugins.Error	Plug-ins 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 do cluster userPluginsSpec.
User.Plugins.InvalidPath	URI de armazenamento malformado para um plug-in.
User.Plugins.PathNotFound	Caminho especificado de 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 nos catálogos do Trino, consulte Perfil de configuração de serviço para obter uma configuração catalogOptions.hive fornecida. Para obter mais informações, consulte Metastore do Hive.

Erros do sistema

Alguns erros poderão ocorrer devido às condições ambientais e serem transitórios. Esses erros começam com o prefixo "System.". Nesses casos, tente as etapas a seguir:

1. Colete as seguintes informações:
   1. CorrelationId de solicitação do Azure. É possível encontrar essa informação na área de Notificação, ou, no Grupo de Recursos em que o cluster está localizado, na página Implantações, ou, na saída do comando az.
   2. DeploymentId. É possível encontrar essa informação na página de 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 do erro	Descrição
System.DependencyFailure	Falha em um dos componentes do cluster.