Migrar offline do Google Cloud SQL para PostgreSQL para o Azure Database for PostgreSQL com o serviço de migração

Este artigo orienta você na migração de uma instância do Google Cloud SQL para PostgreSQL para o servidor flexível do Banco de Dados do Azure para PostgreSQL no modo offline.

O serviço de migração no Banco de Dados do Azure para PostgreSQL é um serviço totalmente gerenciado integrado ao portal do Azure e à CLI do Azure. Ele foi projetado para simplificar seu percurso de migração para o servidor flexível do Banco de Dados do Azure para PostgreSQL.

• Pré-requisitos
• Realizar a migração
• Monitorar a migração
• Verificar a migração quando concluída

Pré-requisitos

Para concluir a migração, você precisa dos seguintes pré-requisitos:

Antes de iniciar a migração com o serviço de migração do Banco de Dados do Azure para PostgreSQL, é importante atender aos seguintes pré-requisitos, especificamente projetados para cenários de migração offline.

• Verificar a versão de origem
• Configurar o destino
• Configurar a instalação da rede
• Habilitar extensões
• Verificar os parâmetros do servidor
• Verificar usuários e funções
• Desabilite a alta disponibilidade (confiabilidade) e as réplicas de leitura no destino

Verificar a versão de origem

A versão do servidor PostgreSQL de origem deve ser 9.5 ou posterior.

Se a versão do PostgreSQL de origem for menor que 9.5, atualize-a para 9.5 ou uma versão superior antes de iniciar a migração.

Configurar o destino

Antes de iniciar a migração, você deve configurar um Banco de Dados do Azure para PostgreSQL no Azure.

A SKU escolhida para o Banco de Dados do Azure para PostgreSQL deve corresponder às especificações do banco de dados de origem para garantir a compatibilidade e o desempenho adequado.

Ao migrar entre versões do PostgreSQL (principais ou secundárias), certifique-de que haja compatibilidade entre seu banco de dados e o aplicativo lendo as notas de versão para detectar possíveis alterações interruptivas.

Configurar a instalação da rede

A configuração de rede é crucial para que o serviço de migração funcione corretamente. Verifique se o servidor PostgreSQL de origem consegue se comunicar com o servidor de destino do Banco de Dados do Azure para PostgreSQL. As configurações de rede a seguir são fundamentais para uma migração bem-sucedida.

Para mais informações sobre a configuração de rede, visite o Guia de rede para o serviço de migração.

Considerações adicionais de rede

Para facilitar a conectividade entre as instâncias postgreSQL de origem e de destino, é essencial verificar e potencialmente modificar o arquivo pg_hba.conf do servidor de origem. Esse arquivo inclui a autenticação do cliente e deve ser configurado para permitir que o PostgreSQL de destino se conecte à origem. As alterações no arquivo pg_hba.conf normalmente exigem uma reinicialização da instância postgreSQL de origem para entrar em vigor.

O arquivo pg_hba.conf está localizado no diretório de dados da instalação do PostgreSQL. Esse arquivo deve ser verificado e configurado, se o banco de dados de origem for um servidor PostgreSQL local ou um servidor PostgreSQL hospedado em uma VM do Azure.

Habilitar extensões

Para garantir uma migração bem-sucedida usando o serviço de migração no Banco de Dados PostgreSQL do Azure, talvez seja necessário verificar as extensões da sua instância PostgreSQL de origem. As extensões fornecem funcionalidades e recursos que podem ser necessários para sua aplicação. Certifique-se de verificar as extensões na instância de origem do PostgreSQL antes de iniciar o processo de migração.

Na instância de destino do servidor flexível do Banco de Dados do Azure para PostgreSQL, habilite as extensões com suporte identificadas na instância postgreSQL de origem.

Para obter mais informações, consulte Extensões e módulos.

Verificar os parâmetros do servidor

Esses parâmetros não são migrados automaticamente para o ambiente de destino e devem ser configurados manualmente.

• Corresponda os valores de parâmetro do servidor do banco de dados PostgreSQL de origem ao Banco de Dados do Azure para PostgreSQL acessando a página de parâmetros do servidor no portal do Azure e atualizando manualmente os valores de acordo.

• Salve as alterações de parâmetro e reinicie o Banco de Dados do Azure para PostgreSQL para aplicar a nova configuração, se necessário.

Verificar usuários e funções

Ao migrar para o Banco de Dados do Azure para PostgreSQL, é essencial abordar a migração de usuários e funções separadamente, pois elas exigem intervenção manual:

• Migração manual de usuários e funções: usuários e funções devem ser migrados manualmente para o Banco de Dados do Azure para PostgreSQL. Para facilitar esse processo, você pode usar o pg_dumpall utilitário com o --globals-only sinalizador para exportar objetos globais, como funções e usuários. Execute o seguinte comando, substituindo <<username>> pelo nome de usuário real e <<filename>> pelo nome de arquivo de saída desejado:

  pg_dumpall --globals-only -U <<username>> -f <<filename>>.sql
  

• Restrição em funções de superusuário: o Banco de Dados do Azure para PostgreSQL não dá suporte a funções de superusuário. Portanto, os usuários com privilégios de superusuário devem ter esses privilégios removidos antes da migração. Certifique-se de ajustar as permissões e as funções adequadamente.

Seguindo estas etapas, você pode garantir que contas de usuário e funções sejam migradas corretamente para o Banco de Dados do Azure para PostgreSQL sem encontrar problemas relacionados a restrições de superusuário.

Desabilite a alta disponibilidade (confiabilidade) e as réplicas de leitura no destino

• Desabilitar a alta disponibilidade (confiabilidade) e ler réplicas no ambiente de destino é essencial. Esses recursos devem ser habilitados somente após a conclusão da migração.

• Ao seguir essas diretrizes, você poderá ajudar a garantir um processo de migração tranquilo, sem as variáveis adicionais introduzidas pela alta disponibilidade e pelas réplicas de leitura. Depois que a migração for concluída e o banco de dados estiver estável, você poderá continuar a habilitar esses recursos para aprimorar a disponibilidade e a escalabilidade do seu ambiente de banco de dados no Azure.

Realizar a migração

Você pode migrar usando o portal do Azure ou a CLI do Azure.

Portal

Este artigo orienta você a usar o portal do Azure para migrar seu banco de dados PostgreSQL de um servidor do Google Cloud SQL para PostgreSQL para um Banco de Dados do Azure para PostgreSQL. O portal do Azure permite que você execute várias tarefas, incluindo a migração de banco de dados. Seguindo as etapas descritas neste tutorial, você pode transferir seu banco de dados diretamente para o Azure e aproveitar seus recursos avançados e escalabilidade.

Configurar a tarefa de migração

O serviço de migração é fornecido com uma experiência simples e baseada em assistente no portal do Azure.

Usando o portal do Azure:

1. Selecione seu servidor flexível do Azure Database for PostgreSQL.

2. No menu de recursos, selecione Migração.

   

3. Selecione Criar para percorrer uma série de guias guiadas por um assistente para realizar a migração de um servidor do Google Cloud SQL para PostgreSQL para um servidor flexível.

   Observação

   Na primeira vez que você usa o serviço de migração, uma grade vazia aparece com um prompt para iniciar sua primeira migração.

   Se as migrações para o destino do servidor flexível já tiverem sido criadas, a grade agora conterá informações sobre tentativas de migrações.

   

Instalação

Você precisa fornecer vários detalhes relacionados à migração, como o nome da migração, o tipo de servidor de origem, a opção e o modo.

• O nome da migração é o identificador exclusivo para cada migração para esse destino de servidor flexível. Esse campo aceita apenas caracteres alfanuméricos e não aceita nenhum caractere especial, exceto um hífen (-). O nome não pode começar com um hífen e deve ser exclusivo de um servidor de destino. Nenhuma migração para o mesmo servidor flexível de destino pode ter o mesmo nome de outra.

• Tipo de servidor de origem – dependendo da fonte do PostgreSQL, você pode selecionar o SQL do Google Cloud para PostgreSQL.

• Opção de migração – permite que você execute validações antes de disparar uma migração. Você pode escolher uma das seguintes opções:

  • Validar – verifica se o seu servidor e seu banco de dados estão preparados para migrar para o destino.
  • Validar e migrar — executa a validação antes de disparar uma migração. Se não houver falhas de validação, a migração será iniciada.

Escolher a opção Validar ou Validar e migrar é sempre uma boa prática para executar validações de pré-imigração antes de executar a migração.

Para saber mais sobre a validação de pré-imigração, visite Pré-imigração.

• Modo de migração permite escolher o modo para a migração. Offline é a opção padrão. Nesse caso, usaremos o padrão.

Selecione Avançar: servidor de runtime.

Servidor de execução

O servidor de runtime de migração é um recurso especializado dentro do serviço de migração no Banco de Dados do Azure para PostgreSQL, projetado para atuar como um servidor intermediário durante a migração. É uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL separada que não é o servidor de destino, mas é usada para facilitar a migração de bancos de dados de um ambiente de origem que só é acessível por meio de uma rede privada.

Para obter mais informações sobre o servidor de runtime, visite o servidor de runtime de migração.

Servidor de origem

A guia Servidor de Origem solicita que você forneça detalhes relacionados à origem selecionada na guia Instalação , que é a origem dos bancos de dados.

• Nome do servidor – forneça o nome do host ou o endereço IP do servidor PostgreSQL de origem.
• Porta – Número da porta do servidor de origem.
• Logon do administrador – nome do usuário administrador do servidor PostgreSQL de origem.
• Senha – senha do logon do administrador fornecida para se conectar ao servidor PostgreSQL de origem.
• Modo SSL – os valores com suporte são preferred e required. Quando o SSL no servidor PostgreSQL de origem estiver OFF, use prefer. Se o SSL no servidor de origem estiver ON, use o require. Os valores SSL podem ser determinados no arquivo postgresql.conf do servidor de origem.
• Testar a conexão – executa o teste de conectividade entre o destino e a origem. Depois que a conexão for bem-sucedida, você poderá prosseguir para a próxima guia. Esses testes visam identificar quaisquer problemas de conectividade que possam existir entre os servidores de destino e de origem, incluindo a verificação da autenticação usando as credenciais fornecidas. Estabelecer uma conexão de teste leva alguns segundos.

Após a conexão de teste bem-sucedida, selecione Avançar: Servidor de destino.

Servidor de destino

A guia Servidor de destino exibe metadados para o destino do servidor flexível, como o nome da assinatura, o grupo de recursos, o nome do servidor, o local e a versão do PostgreSQL.

• Logon do administrador – nome do usuário administrador do servidor PostgreSQL de destino.
• Senha – senha do logon do administrador fornecida para se conectar ao servidor PostgreSQL de destino.
• Endereço IP ou FQDN personalizado: o campo de endereço IP ou FQDN personalizado é opcional e pode ser usado quando o destino está por trás de um servidor DNS personalizado ou tem namespaces DNS personalizados, tornando-o acessível apenas por meio de FQDNs específicos ou endereços IP. Por exemplo, isso pode incluir entradas como production-flexible-server.example.com, 198.1.0.2, ou um FQDN do PostgreSQL, como production-flexible-server.postgres.database.azure.com, se o servidor DNS personalizado contiver a zona DNS postgres.database.azure.com ou encaminhar consultas para essa zona para 168.63.129.16, onde o FQDN é resolvido na zona DNS pública ou privada do Azure.
• Testar a conexão – executa o teste de conectividade entre a origem e o destino. Depois que a conexão for bem-sucedida, você poderá prosseguir para a próxima guia. Esses testes visam identificar quaisquer problemas de conectividade que possam existir entre os servidores de origem e de destino, incluindo a verificação da autenticação usando as credenciais fornecidas. Estabelecer uma conexão de teste leva alguns segundos.

Após a conexão de teste bem-sucedida, selecione o Próximo: Bancos de dados para validar ou migrar

Bancos de dados para validar ou migrar

Na guia Bancos de Dados para validar ou migrar , você pode escolher uma lista de bancos de dados de usuário para migrar do servidor PostgreSQL de origem.

Depois de selecionar os bancos de dados, selecione Avançar: Resumo.

Sumário

A guia Resumo apresenta todos os detalhes de origem e destino para criar a validação ou a migração. Examine os detalhes e selecione Iniciar validação e migração.

Cancelar a validação ou a migração

Você pode cancelar as validações ou migrações em andamento. O fluxo de trabalho deve estar no status Em andamento para que possa ser cancelado. Você não pode cancelar uma validação ou migração no estado Bem-sucedido ou com falha .

• O cancelamento de uma validação interrompe a atividade de validação adicional e a validação é movida para um estado Cancelado .
• O cancelamento de uma migração interrompe qualquer atividade de migração adicional no servidor de destino e passa para um estado Cancelado. A ação cancelar retorna todas as alterações feitas pelo serviço de migração no servidor de destino.

CLI

Este artigo explora o uso da CLI do Azure para migrar seu banco de dados PostgreSQL de uma máquina virtual do Azure ou uma instância local do PostgreSQL para um Banco de Dados do Azure para PostgreSQL. A CLI do Azure fornece uma interface de linha de comando poderosa e flexível que permite executar várias tarefas, incluindo a migração de banco de dados. Seguindo as etapas descritas neste artigo, você pode transferir o seu banco de dados diretamente para o Azure e aproveitar seus recursos avançados e escalabilidade.

Para saber mais sobre a CLI do Azure com o serviço de migração, visite Como configurar a CLI do Azure para o serviço de migração.

Depois que a CLI estiver instalada, abra o prompt de comando e faça logon em sua conta do Azure usando o comando abaixo.

az login

Configurar a tarefa de migração

Para iniciar a migração, crie um arquivo JSON com os detalhes da migração. O arquivo JSON contém as seguintes informações:

• Edite os espaços reservados abaixo << >> nas linhas JSON e armazene-os no computador local como <<filename>>.json em que a CLI está sendo invocada. Neste tutorial, salvamos o arquivo em c:/migration-CLI/migration_body.json

{
"properties": {
"SourceDBServerResourceId": "<<source-server-hostname-or-IP-address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<source-server-administrator-password>>",
                "TargetServerPassword": "<<target-server-administrator-password>>"
            },
            "targetServerUserName": "<<target-server-administrator-login>>"
        },
        "DBsToMigrate": "<<comma-separated-list-of-databases-in-array-like-["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "AWS_AURORA",
        "sslMode": "Prefer"
    }
}

• Execute o comando a seguir para verificar se alguma migração está em execução. O nome da migração é exclusivo entre as migrações no destino do servidor flexível do Banco de Dados do Azure para PostgreSQL.

  az postgres flexible-server migration list --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --filter all
  

• Nas etapas acima, não há migrações executadas, portanto, começamos com a nova migração executando o comando a seguir.

  az postgres flexible-server migration create --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --migration-name <migration> --migration-mode offline --migration-option ValidateAndMigrate --properties "c:/migration-cli/migration_body.json"
  

• Execute o comando a seguir para ver o status da migração iniciada na etapa anterior. Você pode verificar o status da migração fornecendo o nome da migração.

  az postgres flexible-server migration show --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --migration-name <migration>
  

• O progresso e o status da migração são mostrados na CLI do Azure.

• Você também pode ver o progresso e o status no portal do Azure.

• Você pode cancelar todas as tentativas de migração em andamento usando o comando cancel. Esse comando interrompe a tentativa de migração específica e reverte todas as alterações que ele poderia ter feito no servidor de destino. A seguir está o comando da CLI para cancelar a migração que tem um status "Em andamento".

  az postgres flexible-server migration update cancel --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --migration-name <migration>
  

Monitorar a migração

Depois de selecionar o botão Iniciar validação e migração , uma notificação será exibida, em alguns segundos, para dizer que a validação ou a criação da migração foi bem-sucedida. Você é redirecionado automaticamente para a página Migração do servidor flexível. A entrada mostra Status como Em andamento. O fluxo de trabalho leva de 2 a 3 minutos para configurar a infraestrutura de migração e verificar as conexões de rede.

A grade que exibe as migrações tem as seguintes colunas: Nome, Status, Modo de Migração, Tipo de Migração, Servidor de Origem, Tipo de servidor de origem, Bancos de Dados, Duração e Hora de Início. As entradas são exibidas classificadas pela hora de início em ordem decrescente, com a entrada mais recente na parte superior. Você pode usar o botão Atualizar na barra de ferramentas para atualizar o status da validação ou da execução de migração.

Detalhes da migração

Selecione o nome da migração na grade para ver os detalhes associados.

Lembre-se de que, nas etapas anteriores, quando você criou essa migração, configurou a opção de migração como Validar e migrar. Nesse cenário, as validações são executadas primeiro antes do início da migração. Depois que o subestado de Execução das etapas de pré-requisito for concluído, o fluxo de trabalho transitará para o subestado de Validação em andamento.

• Se a validação tiver erros, a migração passa para um estado de Falha.

• Se a validação for concluída sem erros, a migração será iniciada e o fluxo de trabalho passará para o subestado de Migração de dados.

Os detalhes de validação estão disponíveis no nível da instância e do banco de dados.

• Detalhes de validação, por exemplo
  • Contém validação relacionada à verificação de conectividade, versão de origem, ou seja, versão >do PostgreSQL = 9.5 e verificação de parâmetro do servidor, se as extensões estão habilitadas nos parâmetros do servidor flexível do Banco de Dados do Azure para PostgreSQL.
• Detalhes de validação e migração para bancos de dados
  • Ela contém a validação dos bancos de dados individuais relacionados ao suporte a extensões e ordenações no servidor flexível do Banco de Dados do Azure para PostgreSQL.

Você pode ver o status de validação e o status de migração na página de detalhes da migração.

Alguns status de migração possíveis:

Status da migração

Situação	Descrição
Em andamento	A configuração da infraestrutura de migração está em andamento ou a migração de dados real está em andamento.
Cancelado	A migração foi cancelada ou excluída.
Com falha	A migração falhou.
Falha na validação	A validação falhou.
Bem-sucedida	A migração foi bem-sucedida e está concluída.

Substatuses de migração

Substatus	Descrição
Realizando etapas pré-requisitas	A configuração da infraestrutura está em andamento para migração de dados.
Validação em andamento	Validação em andamento.
Migrando dados	Migração de dados em andamento.
Concluindo a migração	A migração está nos estágios finais de conclusão.
Concluído	A migração foi concluída.
Com falha	A migração falhou.

Substatuses de validação

Substatus	Descrição
Com falha	A validação falhou.
Bem-sucedida	A validação foi bem-sucedida.
Aviso	A validação está com um aviso.

Verificar a migração quando concluída

Depois de concluir os bancos de dados, você precisa validar manualmente os dados entre a origem e o destino e verificar se todos os objetos no banco de dados de destino foram criados com êxito.

Após a migração, você pode executar as seguintes tarefas:

• Verifique os dados em seu servidor flexível e verifique se é uma cópia exata da instância de origem.

• Após a verificação, habilite a opção de alta disponibilidade em seu servidor flexível conforme necessário.

• Altere o SKU do servidor flexível para que ele corresponda às necessidades do aplicativo. Essa alteração exige uma reinicialização do servidor de banco de dados.

• Se você alterar os parâmetros de servidor de seus valores padrão na instância de origem, copie esses valores de parâmetro de servidor no servidor flexível.

• Copie outras configurações de servidor, como marcas, alertas e regras de firewall (se aplicável), da instância de origem para o servidor flexível.

• Faça alterações em seu aplicativo para apontar as cadeias de conexão para um servidor flexível.

• Monitore o desempenho do banco de dados de perto para ver se ele exige um ajuste de desempenho.

Conteúdo relacionado

• Migração online do SQL do Google Cloud para o PostgreSQL
• Serviço de migração
• Limitações e problemas conhecidos