Tutorial: Migrar offline do Amazon RDS for PostgreSQL para o Banco de Dados do Azure para PostgreSQL com o serviço de migração

O portal do Azure fornece uma experiência simples e intuitiva baseada em assistente que o orienta durante a migração. Seguindo as etapas descritas neste tutorial, você pode transferir perfeitamente seu banco de dados para o Banco de Dados do Azure para PostgreSQL - Servidor Flexível e aproveitar seus poderosos recursos e escalabilidade.

Para migrar com o portal do Azure, primeiro configure a tarefa de migração, conecte-se à origem e ao destino e, em seguida, execute a migração.

Configurar a tarefa de migração

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

1. Abra o browser e aceda ao portal do Azure. Introduza as suas credenciais para iniciar sessão. A vista predefinida é o dashboard de serviço.

2. Vá para o Banco de Dados do Azure para o servidor flexível PostgreSQL.

3. Na guia Visão geral do servidor flexível, no menu à esquerda, role para baixo até Migração e selecione-a.

   

4. Selecione o botão Criar para migrar do Amazon RDS for PostgreSQL para um servidor flexível.

   Nota

   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.

5. Selecione o botão Criar para percorrer uma série de guias baseadas em assistente para executar uma migração.

   

Configurar

O usuário 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 do 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 do 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.
  • Migrar - Ignora validações e inicia migrações.
  • 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á acionada.

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.

Selecione o botão Next: Connect to source (Avançar: Conectar ao código-fonte ).

Selecionar servidor de tempo de execução

O migration Runtime Server é um recurso especializado dentro do serviço de migração, projetado para atuar como um servidor intermediário durante a migração. É um Banco de Dados do Azure separado para PostgreSQL - instância do Servidor Flexível que não é o servidor de destino, mas é usado 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 Runtime Server, visite o Migration Runtime Server.

Ligar à origem

A guia Conectar à fonte 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 da instância PostgreSQL de origem
• Porta - Número da porta do servidor de origem
• Nome de login do administrador do servidor - Nome de usuário do servidor PostgreSQL de origem
• Senha - Senha do servidor PostgreSQL de origem
• Modo SSL - Os valores suportados são preferenciais e obrigatórios. Quando o SSL no servidor PostgreSQL de origem estiver OFF, use SSLMODE=prefer. Se o SSL no servidor de origem estiver ATIVADO, use SSLMODE=require. Os valores SSL podem ser determinados no arquivo postgresql.conf.
• Testar conexão—Executa o teste de conectividade entre o destino e a origem. Uma vez que a conexão é bem-sucedida, os usuários podem prosseguir para a próxima etapa; Eles precisam identificar os problemas de rede entre o destino e a origem e verificar o nome de usuário/senha da fonte. Estabelecer uma conexão de teste leva alguns minutos.

Após a conexão de teste bem-sucedida, selecione o botão Next: Select Migration target (Avançar: selecionar destino de migração).

Selecionar destino de migração

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

• Admin username - Nome de usuário Admin do servidor PostgreSQL de destino
• Senha - Senha do servidor PostgreSQL de destino
• FQDN/IP personalizado (opcional): O campo FQDN/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 flexibleserver.example.com, 198.1.0.2ou um FQDN do PostgreSQL, como flexibleserver.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 é resolvido na zona DNS pública ou privada do Azure.
• Testar conexão - Executa o teste de conectividade entre o destino e a origem. Quando a conexão for bem-sucedida, os usuários poderão prosseguir com a próxima etapa. Caso contrário, precisamos identificar os problemas de rede entre o destino e a origem e verificar o nome de usuário/senha do destino. A conexão de teste leva alguns minutos para estabelecer uma conexão entre o destino e a origem

Após a conexão de teste bem-sucedida, selecione o botão Avançar: Selecionar banco de dados para migração

Selecionar banco de dados para migração

Na guia Selecionar banco de dados para migração, 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 Next : Summary

Resumo

A guia Resumo resume todos os detalhes de origem e destino para criar a validação ou migração. Reveja os detalhes e selecione o botão Iniciar Validação e Migração.

Monitorize a migração

Depois de selecionar o botão Iniciar Validação e Migração , uma notificação aparece em alguns segundos informando que a validação ou a criação da migração foi bem-sucedida. Você será redirecionado para a instância flexível da página Migração do servidor. A entrada está no estado InProgress e no subestado PerformingPreRequisiteSteps. 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 estas 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 na ordem decrescente da hora de início, com a entrada mais recente no topo. Você pode usar o botão Atualizar para atualizar o status da execução de validação ou migração.

Detalhes da migração

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

Na guia Configuração, selecionamos 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 substrato PerformingPreRequisiteSteps for concluído, o fluxo de trabalho será movido para o substrato de Validação em andamento.

• Se a validação tiver erros, a migração será movida para um estado Falha .

• Se a validação for concluída sem qualquer erro, a migração será iniciada e o fluxo de trabalho será movido para o subestado de Migrando dados.

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

• Validação ao nível da instância

  • Contém validação relacionada à verificação de conectividade, versão de origem, ou seja, versão >do PostgreSQL = 9.5, verificação de parâmetros do servidor, se as extensões estiverem habilitadas nos parâmetros de servidor do Banco de Dados do Azure para PostgreSQL - servidor flexível.

• Validação ao nível da base de dados

  • Ele contém a validação dos bancos de dados individuais relacionados ao suporte a extensões e agrupamentos no Banco de Dados do Azure para PostgreSQL, um servidor flexível.

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

Alguns estados de migração possíveis:

Estados de migração

Subestados de migração

Subestados de validação

Cancelar a migração

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

• 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 reverte 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 do Amazon RDS para PostgreSQL para o 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, você precisa criar 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 na máquina local como <<filename>>.json onde a CLI está sendo invocada. Neste tutorial, salvamos o arquivo em C:\migration-CLI\migration_body.json

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "AWS_RDS",
        "sslMode": "Require"
    }
}

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

  az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
  

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

  az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode offline --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• Execute o seguinte comando para iniciar o status da migração na etapa anterior. Você pode verificar o status da migração fornecendo o nome da migração

  az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

• O status do progresso da migração é mostrado na CLI do Azure.

• Você também pode ver o status do Banco de Dados do Azure para servidor flexível PostgreSQL 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 no servidor de destino. Aqui está o comando da CLI para excluir uma migração:

  az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1