Solucionar erros de extensão de migração do Azure PostgreSQL
Nota
Esta prorrogação está no caminho da reforma. Você deve exportar todas as avaliações prévias.
Este artigo explica como determinar, diagnosticar e corrigir problemas/erros que você pode encontrar ao usar a extensão de migração do Azure PostgreSQL.
Resolver problemas
Para solucionar qualquer problema de extensão de migração do Azure PostgreSQL, você deve descobrir os detalhes sobre o erro e os avisos dos logs gerados. Consulte esta seção para acessar os logs.
Registos
A extensão armazena erros, avisos e outros registos de diagnóstico no diretório de registo predefinido:
- Windows -
C:\Users\<username>\.postgresmigration\logs\ - Linux -
~/.postgresmigration/logs - macOS -
/Users/<username>/.postgresmigration/logs
Nota
Por padrão, a extensão armazena os últimos sete arquivos de log.
Detalhes dos códigos de erro
A seção abaixo fornece mais detalhes sobre códigos de erro, mensagens, possíveis causas e suas respetivas ações de correção.
Código de erro: GE-0000
Mensagem de erro: A coleta de dados falhou com um erro desconhecido. Tente criar uma nova avaliação.
Causas possíveis: Este erro é genérico e pode aparecer por vários motivos.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: FSMB-0000
Mensagem de erro: Falha ao gerar a saída de avaliação com um erro desconhecido.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O usuário pode não ter permissão para gravar na pasta de dados de avaliação.
A pasta de dados de avaliação já está em uso por outro programa.
Ações de correção: você deve garantir que o usuário conectado tenha permissões de gravação na pasta de dados de avaliação. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto. Tente criar uma nova avaliação depois de fechar qualquer ficheiro de avaliação aberto.
Código de erro: FSMB-0001
Mensagem de erro: Falha ao acessar dados de avaliação.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O utilizador pode precisar da permissão apropriada para aceder à pasta de dados de avaliação.
A pasta de dados de avaliação não existe ou está em uso por outro programa.
Ações de correção: você deve garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto.
Código de erro: FSMB-0002
Mensagem de erro: Falha ao analisar os dados de avaliação. Um ficheiro de metadados está danificado ou foi modificado externamente. Tente criar uma nova avaliação.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O arquivo de metadados está corrompido ou modificado externamente.
Precisa de ajuda com a análise correta do JSON para o arquivo de metadados.
Ações de correção: talvez seja necessário excluir a avaliação atual e tentar criar uma nova avaliação. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: FSMB-0003
Mensagem de erro: Falha ao salvar a saída da avaliação com um erro do sistema de arquivos.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O usuário pode precisar da permissão apropriada para usar a pasta de dados de avaliação.
A pasta de dados de avaliação já está em uso por outro programa.
Ações de correção: você deve garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto e existe. Tente criar uma nova avaliação depois de fechar qualquer ficheiro de avaliação aberto.
Código de erro: FSMB-0004
Mensagem de erro: Falha ao salvar a saída de avaliação com um erro de serializador.
Causas possíveis: Os dados de avaliação gerados não puderam ser convertidos para o formato JSON.
Ações de correção: você pode tentar executar uma nova avaliação. Para investigar mais, percorra os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: MDS-0001
Mensagem de erro: Falha ao ler os dados de avaliação com um erro do sistema de arquivos.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O utilizador pode precisar da permissão apropriada para aceder à pasta de dados de avaliação.
A pasta de dados de avaliação não existe ou está em uso por outro programa.
Ações de correção: você deve garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto.
Código de erro: MDS-0002
Mensagem de erro: Falha ao ler os dados de avaliação com um erro do serializador.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O utilizador pode precisar da permissão apropriada para aceder à pasta de dados de avaliação.
A pasta de dados de avaliação não existe ou está em uso por outro programa.
Os dados de avaliação foram gerados por uma versão mais antiga da extensão que já não é suportada.
Ações de correção: você deve garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto. Elimine a avaliação atual e, em seguida, execute uma nova avaliação.
Código de erro: MDS-0003
Mensagem de erro: Falha ao salvar a saída da avaliação com um erro desconhecido.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O usuário pode precisar da permissão apropriada para acessar a pasta escolhida para salvar a avaliação.
A pasta já está em uso por outro programa.
Ações de correção: você deve garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto. Em seguida, tente criar uma nova avaliação depois de fechar qualquer ficheiro de avaliação aberto.
Código de erro: MDS-0004
Mensagem de erro: Falha ao salvar a saída de avaliação com um erro de serializador.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O arquivo de metadados está corrompido ou modificado externamente.
Precisa de ajuda com a análise correta do JSON para o arquivo de metadados.
Ações de correção: talvez seja necessário excluir a avaliação atual e tentar criar uma nova avaliação. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: FSRP-0000
Mensagem de erro: Ocorreu um erro de terminal - falha ao acessar dados de pesquisa. Um ficheiro de pesquisa foi eliminado ou está danificado. Reinstale a extensão e tente novamente.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O arquivo de metadados de pesquisa é excluído ou corrompido.
O arquivo de metadados de pesquisa já está em uso por outro programa.
Ações de correção: tente reinstalar a extensão, feche qualquer arquivo de avaliação aberto e crie uma nova avaliação. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: FSRP-0001
Mensagem de erro: Ocorreu um erro de terminal - falha ao acessar dados de pesquisa. Um ficheiro de pesquisa foi eliminado ou está danificado. Reinstale a extensão e tente novamente.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
O arquivo de metadados de pesquisa é excluído ou corrompido.
O arquivo de metadados de pesquisa já está em uso por outro programa.
Ações de correção: tente reinstalar a extensão, feche qualquer arquivo de avaliação aberto e crie uma nova avaliação. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: GE-0001
Mensagem de erro: Falha ao executar um ou mais componentes de avaliação com um erro desconhecido.
Causas possíveis: Ocorreu um erro interno desconhecido.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra o log para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: GE-1002
Mensagem de erro: A pasta de avaliação configurada não existe.
Causas possíveis: O caminho da pasta de avaliação fornecido não existe localmente.
Ações de correção: verifique se o caminho da pasta de avaliação existe no computador local. Se alterou o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas definições da extensão está correto.
Código de erro: PGSQLC - 0000
Mensagem de erro: A coleta de dados falhou com um erro desconhecido. Tente criar uma nova avaliação.
Causas possíveis: Este erro é genérico e pode aparecer por vários motivos.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLC-0001
Mensagem de erro: Falha ao coletar dados de compatibilidade do PostgreSQL Server com um erro desconhecido.
Causas possíveis: Este erro ocorre durante a recolha de dados de compatibilidade do servidor.
Ações de correção: para investigar mais, examine os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLC-0002
Mensagem de erro: Falha ao coletar dados de compatibilidade do banco de dados PostgreSQL com um erro desconhecido.
Causas possíveis: Este erro ocorre durante a coleta de dados de compatibilidade de banco de dados.
Ações de correção: para investigar mais, examine os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLC-0003
Mensagem de erro: Falha ao processar os dados de desempenho.
Possíveis causas: Este erro ocorreu durante a coleta de dados de desempenho do PostgreSQL.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra o log para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLA-1000
Mensagem de erro: O módulo de compatibilidade do servidor para a plataforma de destino do Azure PostgreSQL falhou com um erro desconhecido.
Causas possíveis: O módulo de compatibilidade do servidor falhou ao processar os dados de compatibilidade do servidor.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLA-2000
Mensagem de erro: Os dados de compatibilidade de banco de dados para a plataforma de destino PostgreSQL do Azure falharam com um erro desconhecido.
Causas possíveis: O módulo de compatibilidade de banco de dados falhou ao processar os dados de compatibilidade do banco de dados.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLA-3001
Mensagem de erro: A recomendação de SKU para a plataforma de destino do Azure PostgreSQL falhou com um erro desconhecido.
Causas possíveis: A recomendação de SKU falhou ao processar os dados de desempenho.
Ações de correção: tente criar uma nova avaliação. Para investigar mais, percorra os logs para entender o motivo do erro. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGSQLDA-0001
Mensagem de erro: Falha ao agregar os detalhes de dados de desempenho coletados com um erro desconhecido.
Causas possíveis: Falha ao processar os dados de desempenho.
Ações de correção: para investigar mais, examine os logs para entender o motivo do erro. contacte a Microsoft para obter ajuda.
Código de erro: PGDC-10000
Mensagem de erro: Falha ao coletar dados necessários com um erro PG subjacente. Veja a documentação do Postgres referente a este código de erro.
Causas possíveis: A avaliação falhou devido a um erro PostgreSQL subjacente
Ações de correção: talvez seja necessário consultar a documentação do PG para resolver esse problema. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGDC-10001
Mensagem de erro: Conexão perdida. Verifique a conectividade da rede. Veja a documentação do Postgres referente a este código de erro.
Causas possíveis: A avaliação falhou devido a um problema de conectividade de rede.
Ações de correção: talvez seja necessário consultar a documentação do PG para resolver esse problema. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGDC-10002
Mensagem de erro: A conexão expirou para o servidor PostgreSQL. Navegue para o painel de ligações e atualize a ligação ao Servidor PostgreSQL.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas-
A conexão do PostgreSQL Server foi encerrada com força ou atingiu o tempo limite.
A conectividade de rede com o PostgreSQL Server é instável ou perdida.
Ações de correção: tente se reconectar ao PostgreSQL Server ou atualizar a conexão. Além disso, execute o ping no Servidor PostgreSQL para verificar se a conectividade de rede entre a máquina virtual e o Servidor PostgreSQL é estável. Verifique se os parâmetros de tempo limite foram definidos corretamente no ficheiro postgresql.conf.
Código de erro: PGDC-10003
Mensagem de erro: Falha de login devido a credenciais inválidas. Verifique as credenciais de início de sessão da base de dados e tente novamente.
Causas possíveis: A falha de login pode ser devido a credenciais inválidas.
Ações de correção: você deve garantir que as credenciais do PostgreSQL Server fornecidas estejam corretas. Verifique as credenciais de início de sessão da base de dados e tente novamente.
Código de erro: PGDC-10004
Mensagem de erro: O PostgreSQL Server conectado não está disponível devido a uma exceção PG subjacente.
Causas possíveis: O banco de dados pode estar inativo ou não querer aceitar conexões.
Ações de correção: verifique se o banco de dados está online, íntegro e pronto para aceitar novas conexões. Para obter mais informações, veja a documentação do Postgres.
Código de erro: PGDC-10005
Mensagem de erro: O usuário não tem o privilégio de acessar a tabela/exibição para avaliação.
Causas possíveis: Este erro pode aparecer devido a qualquer uma das razões dadas -
Falta de privilégio Connect.
Falta de privilégio Select.
Ações de correção: forneça a permissão necessária ao usuário da Avaliação. Se o problema persistir, contacte a Microsoft para obter ajuda.
Código de erro: PGDC-10006
Mensagem de erro: Nenhum host é conhecido. Ligue-se a um anfitrião válido.
Causas possíveis: O host não é válido. O endereço IP, o nome do anfitrião ou o número da porta estão incorretos.
Ações de correção: verifique se o nome do host e o número da porta estão corretos. Se o problema persistir, contacte a Microsoft para obter ajuda.