Migre offline, de um Amazon RDS para PostgreSQL para o Banco de Dados do Azure para PostgreSQL, com o serviço de migração

Este artigo orienta você usando o portal do Azure para migrar seu banco de dados PostgreSQL de um servidor Amazon RDS for 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 perfeitamente seu banco de dados para o Azure e aproveitar seus poderosos recursos e escalabilidade.

Configurar a tarefa de migração

O serviço de migração oferece uma experiência simples orientada por assistente no portal do Azure.

Usando o portal do Azure:

1. Selecione o 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 baseadas em assistente para executar uma migração para um servidor flexível a partir de um Amazon RDS for PostgreSQL.

   Note

   Na primeira vez que você usar o serviço de migração, uma grade vazia será exibida com um prompt para iniciar sua primeira migração.

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

   

Setup

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 de cada migração para esse destino de servidor flexível. Este 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 para um servidor de destino. Não há duas migrações para o mesmo destino de servidor flexível que possam ter o mesmo nome.

• Tipo de servidor de origem - Dependendo da origem do PostgreSQL, você pode selecionar o Amazon RDS for PostgreSQL.

• Opção de migração - Permite executar validações antes de acionar uma migração. Você pode escolher qualquer uma das seguintes opções:

  • Validar - Verifica a preparação do servidor e do banco de dados para a migração para o destino.
  • Validar e migrar — Executa a validação antes de acionar 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é-migração antes de executar a migração.

Para saber mais sobre a validação pré-migração, visite pré-migração.

• O modo de migração permite que você escolha o modo para a migração. Offline é a opção padrão. Nesse caso, usaremos o padrão.

Selecione Próximo: Servidor de Execução.

Runtime server

O servidor de tempo de execução da 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 separada do Banco de Dados do Azure para PostgreSQL que não é o servidor de destino, mas é usada para facilitar a migração de bancos de dados de um ambiente de origem acessível apenas por meio de uma rede privada.

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

Source server

A guia Servidor de origem solicita que você forneça detalhes relacionados à fonte selecionada na guia Configuraçã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.
• Login de administrador - Nome do usuário administrador do servidor PostgreSQL de origem.
• Senha - Senha do login do administrador fornecida para se conectar ao servidor PostgreSQL de origem.
• Modo SSL - Os valores suportados são preferred e required. Quando o SSL no servidor PostgreSQL de origem for OFF, use prefer. Se o SSL no servidor de origem for ON, use o require. Os valores SSL podem ser determinados no arquivo postgresql.conf do servidor de origem.
• Testar conexão — Executa o teste de conectividade entre o destino e a origem. Quando 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.

Target server

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

• Login de administrador - Nome do usuário administrador do servidor PostgreSQL de destino.
• Senha - Senha do login do administrador fornecida para se conectar ao servidor PostgreSQL de destino.
• FQDN ou endereço IP personalizado: O campo FQDN ou endereço IP personalizado é opcional e pode ser usado quando o destino está atrás de um servidor DNS personalizado ou tem namespaces DNS personalizados, tornando-o acessível apenas por meio de FQDNs ou endereços IP específicos. 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 postgres.database.azure.com DNS ou encaminhar consultas para essa zona para 168.63.129.16, onde o FQDN for resolvido na zona DNS pública ou privada do Azure.
• Testar conexão — Executa o teste de conectividade entre a origem e o destino. Quando 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 Next : Databases para validar ou migrar

Bases 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ários para migrar do seu servidor PostgreSQL de origem.

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

Summary

A aba Resumo apresenta de forma resumida todos os detalhes de origem e destino para criar a validação ou migração. Reveja os detalhes e selecione Iniciar validação e migração.

Cancelar a validação ou migração

Você pode cancelar todas as validações ou migrações em andamento. O fluxo de trabalho deve estar no status Em andamento para que possa ser cancelado. Não é possível cancelar uma validação ou migração no estado Bem-sucedido ou Reprovado .

• O cancelamento de uma validação interrompe outras atividades de validação e a validação é movida para um estado Cancelado .
• O cancelamento de uma migração interrompe a 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.

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 do PostgreSQL local 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 perfeitamente seu banco de dados para o Azure e aproveitar seus poderosos recursos 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 marcadores de posição << >> nas linhas de JSON abaixo e armazene-os na máquina local como <<filename>>.json, onde a CLI está a ser 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_RDS",
        "sslMode": "Prefer"
    }
}

• Execute o seguinte comando para verificar se alguma migração está em execução. O nome da migração é único entre as migrações no Banco de Dados do Azure para o servidor flexível 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 realizadas, então começamos com a nova migração executando o seguinte comando.

  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 seguinte comando 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 cancel comando. Este 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>