Solucionar problemas na extensão de migração do Azure PostgreSQL
Observação
Esta extensão está no caminho da desativação. Você deve exportar todas as avaliações anteriores.
Este artigo explica como determinar, diagnosticar e consertar problemas/erros que você pode encontrar ao usar a extensão de migração do Azure PostgreSQL.
Solucionar problemas
Para solucionar qualquer problema na extensão de migração do Azure PostgreSQL, encontre os detalhes sobre o erro e os avisos nos logs gerados. Veja esta seção para acessar os logs.
Logs
A extensão armazena erros, avisos e outros logs de diagnóstico no diretório de log padrão:
- Windows -
C:\Users\<username>\.postgresmigration\logs\ - Linux –
~/.postgresmigration/logs - macOS –
/Users/<username>/.postgresmigration/logs
Observação
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 os códigos de erro, as mensagens, as possíveis causas e as respectivas 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.
Possíveis causas: esse erro é genérico e pode aparecer por vários motivos.
Ações de correção: tente criar outra avaliação. Para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: FSMB-0000
Mensagem de erro: falha ao gerar a saída da avaliação com um erro desconhecido.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
Talvez o usuário não tenha permissão de gravação 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ê precisa garantir que o usuário conectado tenha permissões gravadas na pasta de dados de avaliação. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de extensão está correto. Tente criar uma nova avaliação depois de fechar todos os arquivos de avaliação abertos.
Código de erro: FSMB-0001
Mensagem de erro: falha ao acessar dados da avaliação.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
Talvez o usuário não tenha a permissão apropriada para acessar a pasta de dados de avaliação.
A pasta de dados de avaliação não existe ou está sendo usada por outro programa.
Ações de correção: você precisa garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de extensão está correto.
Código de erro: FSMB-0002
Mensagem de erro: Falha ao analisar os dados da avaliação. Um arquivo de metadados foi corrompido ou modificado externamente. Tente criar uma nova avaliação.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
O arquivo de metadados foi corrompido ou modificado externamente.
Você precisa de ajuda para analisar o JSON do arquivo de metadados corretamente.
Ações de correção: talvez seja necessário excluir a avaliação atual e tentar criar outra. Se o problema persistir, contate 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.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
Talvez o usuário precise 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ê precisa garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de extensão existe e se ele está correto. Tente criar uma nova avaliação depois de fechar todos os arquivos de avaliação abertos.
Código de erro: FSMB-0004
Mensagem de erro: Falha ao salvar a saída da avaliação com um erro do 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 investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: MDS-0001
Mensagem de erro: falha ao ler os dados da avaliação com um erro do sistema de arquivos.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
Talvez o usuário não tenha a permissão apropriada para acessar a pasta de dados de avaliação.
A pasta de dados de avaliação não existe ou está sendo usada por outro programa.
Ações de correção: você precisa garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de extensão está correto.
Código de erro: MDS-0002
Mensagem de erro: falha ao ler os dados da avaliação com um erro do serializador.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
Talvez o usuário não tenha a permissão apropriada para acessar a pasta de dados de avaliação.
A pasta de dados de avaliação não existe ou está sendo usada por outro programa.
Os dados de avaliação foram gerados por uma versão mais antiga da extensão que não tem mais suporte.
Ações de correção: você precisa garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de extensão está correto. Tente excluir 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.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
Talvez o usuário não tenha a 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ê precisa garantir que o usuário conectado tenha permissões de leitura e gravação na pasta de dados de avaliação. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de extensão está correto. Em seguida, tente criar outra avaliação depois de fechar os arquivos de avaliação abertos.
Código de erro: MDS-0004
Mensagem de erro: falha ao salvar a saída da avaliação com um erro do serializador.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
O arquivo de metadados foi corrompido ou modificado externamente.
Você precisa de ajuda para analisar o JSON do arquivo de metadados corretamente.
Ações de correção: talvez seja necessário excluir a avaliação atual e tentar criar outra. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: FSRP-0000
Mensagem de erro: Ocorreu um erro do terminal – Falha ao acessar os dados de pesquisa. Um arquivo de pesquisa foi excluído ou corrompido. Reinstale a extensão e tente novamente.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
O arquivo de metadados de pesquisa foi excluído ou corrompido.
O arquivo de metadados de pesquisa já está sendo usado por outro programa.
Ações de correção: tente reinstalar a extensão, feche todos os arquivos de avaliação abertos e crie outra avaliação. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: FSRP-0001
Mensagem de erro: Ocorreu um erro do terminal – Falha ao acessar os dados de pesquisa. Um arquivo de pesquisa foi excluído ou corrompido. Reinstale a extensão e tente novamente.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
O arquivo de metadados de pesquisa foi excluído ou corrompido.
O arquivo de metadados de pesquisa já está sendo usado por outro programa.
Ações de correção: tente reinstalar a extensão, feche todos os arquivos de avaliação abertos e crie outra avaliação. Se o problema persistir, contate 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.
Possíveis causas: ocorreu um erro interno desconhecido.
Ações de correção: tente criar uma nova avaliação. Para analisá-lo mais detalhadamente, acesse o log para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: GE-1002
Mensagem de erro: A pasta de avaliação configurada não existe.
Possíveis causas: 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. Caso você tenha alterado o caminho da pasta de dados de avaliação, verifique se o caminho de avaliação atual mencionado nas configurações de 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.
Possíveis causas: esse erro é genérico e pode aparecer por vários motivos.
Ações de correção: tente criar outra avaliação. Para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGSQLC-0001
Mensagem de erro: falha ao coletar os dados de compatibilidade do servidor PostgreSQL com um erro desconhecido.
Possíveis causas: esse erro ocorre durante a coleta de dados de compatibilidade do servidor.
Ações de correção: para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGSQLC-0002
Mensagem de erro: falha ao coletar os dados de compatibilidade do banco de dados PostgreSQL com um erro desconhecido.
Possíveis causas: esse erro ocorre durante a coleta de dados de compatibilidade do banco de dados.
Ações de correção: para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGSQLC-0003
Mensagem de erro: falha ao processar os dados de desempenho.
Possíveis causas: esse erro ocorreu durante a coleta de dados de desempenho do PostgreSQL.
Ações de correção: tente criar uma nova avaliação. Para analisá-lo mais detalhadamente, acesse o log para entender o motivo do erro. Se o problema persistir, contate 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 teve uma falha com um erro desconhecido.
Possíveis causas: falha no módulo de compatibilidade do servidor ao processar os dados de compatibilidade do servidor.
Ações de correção: tente criar uma nova avaliação. Para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGSQLA-2000
Mensagem de erro: falha nos dados de compatibilidade do banco de dados para a plataforma de destino do Azure PostgreSQL com um erro desconhecido.
Possíveis causas: o módulo de compatibilidade do 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 investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGSQLA-3001
Mensagem de erro: falha na recomendação de SKU para a plataforma de destino do Azure PostgreSQL com um erro desconhecido.
Possíveis causas: a recomendação de SKU falhou ao processar os dados de desempenho.
Ações de correção: tente criar outra avaliação. Para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGSQLDA-0001
Mensagem de erro: falha ao agregar os detalhes dos dados de desempenho coletados com um erro desconhecido.
Possíveis causas: falha ao processar os dados de desempenho.
Ações de correção: para investigá-lo mais detalhadamente, acesse os logs para entender o motivo do erro. Entre em contato com a Microsoft para obter ajuda.
Código de erro: PGDC-10000
Mensagem de erro: falha ao coletar os dados necessários com um erro do PG subjacente. Verifique este código de erro na documentação do Postgres.
Possíveis causas: ocorreu uma falha na avaliação devido a um erro subjacente do PostgreSQL
Ações de correção: talvez seja necessário ver a documentação do PG para resolver esse problema. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGDC-10001
Mensagem de erro: conexão perdida. Verifique sua conectividade de rede. Verifique este código de erro na documentação do Postgres.
Possíveis causas: falha na avaliação devido a um problema de conectividade de rede.
Ações de correção: talvez seja necessário ver a documentação do PG para resolver esse problema. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGDC-10002
Mensagem de erro: a conexão com o servidor PostgreSQL atingiu o tempo limite. Navegue até o painel de conexões e atualize a conexão com o servidor PostgreSQL.
Possíveis causas: esse erro pode aparecer devido a qualquer um dos motivos especificados
A conexão do servidor PostgreSQL foi forçada a ser encerrada ou atingiu o tempo limite.
A conectividade de rede com o servidor PostgreSQL está instável ou foi perdida.
Ações de correção: tente se reconectar ao servidor PostgreSQL ou atualizar a conexão. Além disso, execute ping no servidor PostgreSQL para verificar se a conectividade de rede entre o computador e o servidor PostgreSQL é estável. Verifique se os parâmetros de tempo limite estão definidos corretamente no arquivo postgresql.conf.
Código de erro: PGDC-10003
Mensagem de erro: falha no logon devido a credenciais inválidas. Verifique as credenciais de logon do banco de dados e tente novamente.
Possíveis causas: a falha de logon pode ser devido a credenciais inválidas.
Ações de correção: verifique se as credenciais do servidor PostgreSQL fornecidas estão corretas. Verifique as credenciais de logon do banco de dados e tente novamente.
Código de erro: PGDC-10004
Mensagem de erro: o servidor PostgreSQL conectado não está disponível devido a uma exceção de PG subjacente.
Possíveis causas: o banco de dados pode estar inativo ou não está pronto para 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, confira 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 da avaliação.
Possíveis causas: esse erro pode aparecer devido a um dos motivos especificados –
Falta de privilégio de conexão.
Falta de privilégio de seleção.
Ações de correção: forneça a permissão necessária ao usuário de avaliação. Se o problema persistir, contate a Microsoft para obter ajuda.
Código de erro: PGDC-10006
Mensagem de erro: este host não é conhecido. Conecte-se a um host válido.
Causas possíveis: o host não é válido. O endereço IP/nome do host está incorreto ou o número da porta está errado.
Ações de correção: verifique se o nome do host e o número da porta estão corretos. Se o problema persistir, contate a Microsoft para obter ajuda.