Diagnosticar problemas nas migrações do Oracle para o AlloyDB para PostgreSQL

Esta página lista erros conhecidos e etapas recomendadas de solução de problemas para:

Erros encontrados durante o job de migração
Problemas encontrados ao estabelecer a conectividade de rede
Erros encontrados ao trabalhar com o Oracle SCAN

Erros do job de migração

O processo do job de migração pode gerar erros durante a execução.

Alguns erros, como uma senha incorreta no banco de dados de origem, são recuperáveis. O job de migração é retomado automaticamente depois que esses erros são corrigidos.
Alguns erros são irrecuperáveis, como erros na replicação de dados. É necessário reiniciar o job de migração depois que esses erros forem corrigidos.

Quando ocorre um erro, o status do job de migração muda para Failed, e o substatus reflete o último status antes da falha. Para resolver um problema, acesse o job de migração com falha para ver o erro e siga as etapas descritas na mensagem de erro. Para ver mais detalhes sobre o erro, acesse o Cloud Monitoring usando o link no job de migração. Os registros são filtrados para o job de migração específico.

Na tabela a seguir, você encontra alguns exemplos de problemas e como eles podem ser resolvidos:

Sintoma	Causas possíveis	O que você pode tentar
Mensagem de erro: `Database Migration Service can't set up a tunnel to be connected to the bastion host`.	O Database Migration Service não conseguiu acessar o Bastion Host ou ele não está aceitando conexões.	Verifique as configurações do túnel SSH de encaminhamento no perfil de conexão de origem e na configuração do servidor de túnel SSH e tente novamente.
Mensagem de erro: `Database Migration Service can't connect to the database` ou `Database Migration Service private connectivity error, cannot connect to the database`.	O Database Migration Service não conseguiu estabelecer conectividade com o banco de dados Oracle de origem.	Verifique se você pode acessar o banco de dados de origem no seu projeto. Confira as configurações relacionadas ao seu método de configuração de conectividade de origem. Se houver um código de erro específico do Oracle incluído, por exemplo `ORA-12170: TNS:Connect timeout occurred`, consulte a documentação do Oracle para mais informações.
Mensagem de erro: `Archiving mode is not ARCHIVELOG`.	O banco de dados de origem não está em execução no modo `ARCHIVELOG`.	Configure o banco de dados de origem para usar o modo `ARCHIVELOG`. Para mais informações, consulte Configurar seu banco de dados Oracle de origem.
Mensagem de erro: `Supplemental logging ("ALL COLUMN LOGGING") isn't turned on for the tables listed below`.	O banco de dados de origem não tem dados de registro complementares ativados.	Ative os dados de registro complementares e defina o modo como `ALL`. Para mais informações, consulte Configurar seu banco de dados Oracle de origem.
Mensagem de erro: `No Archive Log Files were found in the source`.	O Database Migration Service só lê registros de arquivo fechados, e nenhum registro foi encontrado no banco de dados de origem.	Execute o seguinte comando no banco de dados de origem para fechar o arquivo de registro atual: `ALTER SYSTEM SWITCH LOGFILE`. Tente encontrar os registros novamente. Se o banco de dados não tiver operações de gravação ativas, talvez seja necessário realizar pelo menos uma operação `INSERT` para acionar a criação do registro.
Mensagem de erro: `We're missing the necessary permissions to read from the source`.	A conta de usuário de migração no banco de dados de origem não tem as permissões necessárias.	O Database Migration Service se conecta à origem como a conta de usuário que você configura no perfil de conexão de origem. Essa conta precisa de um conjunto específico de permissões (por exemplo `SELECT ANY TABLE`) para ler dados no banco de dados de origem. Verifique se a conta de usuário de migração tem os privilégios necessários. Para mais informações, consulte Configurar seu banco de dados Oracle de origem.
Mensagem de erro: `Unable to connect to the destination database`.	Ocorreu um problema ao se conectar ao banco de dados de destino.	Verifique se você pode acessar o banco de dados de destino no seu projeto. Confira as configurações relacionadas ao seu método de configuração de conectividade de destino.
Mensagem de erro: `The following tables don't exist in the destination database: {table_names}`.	As tabelas listadas que você está tentando migrar não existem no banco de dados de destino.	O Database Migration Service cria a tabela e as definições necessárias quando você converte o esquema de origem.
Mensagem de erro: `password authentication failed for user {username}`.	O nome de usuário ou a senha do banco de dados de destino estão configurados incorretamente.	Verifique se o perfil de conexão de destino do PostgreSQL está configurado corretamente com o nome de usuário e a senha certos.
Mensagem de erro: `The following tables in the destination database don't have primary keys: {table_names}`.	As tabelas listadas na mensagem de erro existem no banco de dados de destino, mas não têm chaves primárias.	Os espaços de trabalho de conversão do Database Migration Service adicionam automaticamente chaves primárias para tabelas que não as têm quando você converte o esquema. Se você usar espaços de trabalho de conversão legados, será necessário criar as chaves primárias manualmente no destino. Para mais informações, consulte Espaços de trabalho de conversão legados.
Alerta: `The following tables have foreign keys: {table_names}`.	As tabelas listadas na mensagem de erro existem no banco de dados de destino, mas têm chaves externas.	O Database Migration Service não replica dados de maneira transacional, então as tabelas podem ser migradas fora de ordem. Se houver chaves externas, e uma tabela filha que usa uma chave externa for migrada antes da mãe, você poderá encontrar erros de replicação. Para evitar esses problemas de integridade de dados, pule as chaves externas usando a `REPLICATION` opção para o usuário de migração. Para mais informações, consulte Considerações sobre chaves externas e acionadores.
Mensagem de erro: `Unable to resume replication as log position is lost`.	Esse erro pode ocorrer quando o processo de replicação é pausado por muito tempo, levando à perda da posição do registro.	Um job de migração não pode ser pausado por mais tempo do que (ou próximo de) o período de armazenamento de registros. Se a posição do registro for perdida, será necessário recriar o job de migração.
Mensagem de erro: `ORA-00942: table or view does not exist`.	Esse erro pode ocorrer como resultado do armazenamento em cache no servidor Oracle.	Recrie o usuário do banco de dados para corrigir o problema de armazenamento em cache.
O job de migração permanece na fase de despejo completo e não avança para a fase de captura de dados alterados (CDC).	O Database Migration Service ainda está realizando o despejo completo de algumas das tabelas, ou uma ou mais tabelas não podem concluir o despejo completo devido a erros.	Verifique os erros do job de migração e corrija os erros que se aplicam às tabelas ou remova as tabelas associadas do job. Verifique os registros do Database Migration Service para a atividade de despejo completo em andamento e aguarde até que ela seja concluída.

Problemas de conectividade

Esta seção lista e descreve as etapas de solução de problemas para possíveis problemas de conectividade de rede.

Não é possível se conectar ao banco de dados de destino: EOF

A execução de um teste de conectividade retorna a mensagem de erro [DATABASE] unable to connect to the destination database: EOF.

Possível causa:o anexo de serviço está configurado incorretamente.

O que você pode tentar:verifique se enable_proxy_protocol está definido como false no arquivo de configuração do Terraform do anexo de serviço. O protocolo de proxy é compatível apenas com servidores HTTP, como NGINX e Apache.

Ao usar gcloud para criar a configuração do Private Service Connect, o protocolo de proxy é desativado por padrão.

Tempo limite de conexão, conexão recusada

A execução do teste de conectividade falha ou atinge o tempo limite. Isso provavelmente é causado por um roteamento mal configurado na configuração do Private Service Connect. Há vários motivos para esse problema.

Possível causa:há uma regra de firewall ausente que permite que o intervalo CIDR do NAT do Private Service Connect acesse a sub-rede do Private Service Connect em que o bastion está localizado, especificamente a interface nic0 da VM do bastion.

O que você pode tentar:verifique se a política da organização não restringe as regras de firewall internas, como a regra de firewall psc_sp_in_fw definida no script de exemplo do Terraform para configurar a conectividade de IP particular de destino para instâncias do AlloyDB para PostgreSQL não ativadas para PSC.

Possível causa:o proxy está inativo. Não há listener na porta fornecida e, portanto, a conexão fica suspensa.

O que você pode tentar:tente estabelecer uma conexão SSH com a VM do bastion e pesquise o proxy usando o seguinte comando:

netstat -tunalp | grep PORT

Analise as respostas ao comando:

Se você receber uma resposta vazia, o proxy estará inativo. Tente executar os seguintes comandos:

sudo su; cd / e verifique se o servidor Dante está instalado executando sudo dpkg -s dante-server:
- Se o proxy estiver instalado, você receberá a seguinte mensagem:
  
  Status: install ok installed
- Se o proxy não estiver instalado, o problema provável será um roteador ausente. Adicione um roteador e verifique se é possível fazer o download do proxy executando apt-get install dante-server.
  
  Para saber como adicionar um roteador, confira como os recursos psc_sp_ex_router e psc_sp_ex_router_nat são adicionados no arquivo main.tf em Configurar a conectividade de IP particular de destino para instâncias do AlloyDB para PostgreSQL não ativadas para PSC.
Se o proxy estiver em execução e escutando na porta fornecida, tente abrir uma conexão com ele fazendo o seguinte:
1. Instalar o cliente do PostgreSQL:
  
  sudo apt-get install postgresql-client.
2. Conectar ao banco de dados PostgreSQL:
  
  psql -h 127.0.0.1 -p PORT -U DBUSERNAME -W (você vai receber uma solicitação para inserir a senha).
  
  Substitua:
  - PORT: o número da porta do banco de dados.
  - DBUSERNAME: o nome de usuário usado para se conectar ao banco de dados PostgreSQL.
3. Instalar o cliente telnet:
  
  sudo apt-get install telnet
4. Conectar ao cliente telnet:
  
  telnet 127.0.0.1 PORT
  
  Substitua PORT pelo número da porta do banco de dados.
Dependendo dos resultados dos comandos:
- Se os comandos não conseguirem abrir uma conexão, tente consultar os registros de proxy para localizar a causa raiz. A causa raiz pode variar dependendo da configuração da instância do AlloyDB para PostgreSQL.
- Se a conexão for aberta usando telnet, mas ficar suspensa no cliente, o problema provável será o roteamento do endereço IP do bastion. Na VM, digite ip route no terminal. Verifique se é possível localizar uma regra de roteamento que roteia conexões para o endereço IP particular da instância do AlloyDB para PostgreSQL usando o nic secundário (nic1, o endereço IP DB_SUBNETWORK_GATEWAY).

Possível causa:o anexo de serviço não aceita a conexão de endpoint do Database Migration Service. O anexo de serviço contém uma lista de projetos aceitos, e o projeto do Database Migration Service não está incluído na lista.

O que você pode tentar:para resolver o problema, tente uma das seguintes opções:

No Google Cloud console do, acesse Private Service Connect.

Acessar Private Service Connect

Na guia Serviços publicados, aceite a conexão do Database Migration Service para o anexo de serviço (se estiver pendente).
Adicione o projeto solicitante aos projetos permitidos no anexo de serviço (se ele for rejeitado).
- Para mais informações sobre como adicionar um projeto permitido no Terraform, consulte a documentação do Terraform.
- Para mais informações sobre como adicionar um projeto permitido em gcloud, consulte a documentação de referência da Google Cloud CLI.
Se isso não resolver o problema, recrie o perfil de conexão.
Exclua o perfil de conexão associado à conectividade do Private Service Connect e recrie-o.

Resolver problemas de erros do Oracle SCAN

Esta seção descreve possíveis problemas que você pode ter ao migrar de origens do Oracle Real Application Clusters (RAC) usando o recurso Single Client Access Name (SCAN).

Não é possível estabelecer conectividade com um banco de dados Oracle SCAN

A execução do teste de conectividade falha ou atinge o tempo limite.

Possível causa:você pode estar tentando estabelecer conectividade diretamente com o banco de dados de origem do Oracle SCAN. O Database Migration Service não oferece suporte à conectividade direta com bancos de dados usando o recurso SCAN em ambientes Oracle RAC.