Compartilhar via

Como configurar a CLI do Azure para o serviço de migração no Banco de Dados do Azure para PostgreSQL – Servidor Flexível

  • Artigo

A CLI do Azure é um conjunto de comandos usados em todos os serviços do Azure para criar e gerenciar recursos. Ela fornece os mesmos recursos do portal do Azure, mas é otimizada para usuários que preferem trabalhar em um ambiente de linha de comando. Para começar a migrar usando a CLI do Azure, você precisa instalar a CLI do Azure em seu computador local.

Pré-requisitos

  • Instalar a CLI do Azure: dependendo do sistema operacional, baixe e instale a CLI do Azure. Está disponível para o Windows, o macOS e o Linux.
  • Guia de instalação da CLI do Azure: siga as instruções fornecidas na documentação oficial do Azure para instalar a CLI do Azure – Como instalar a CLI do Azure.
  • Verifique a versão da CLI do Azure: verifique se a versão da CLI do Azure é pelo menos 2.56.0 ou superior, pois isso é necessário para o serviço de migração. Use o comando az --version para verificar a versão atual.
  • Entrar no Azure: após a instalação, execute az login para autenticar. Isso abre seu navegador padrão para concluir o processo de entrada com suas credenciais do Azure.

Estas etapas preparam seu ambiente para usar a CLI do Azure para gerenciar com eficiência o serviço de migração no Banco de Dados do Azure para PostgreSQL. Sempre consulte a documentação mais recente do Azure para ver as atualizações ou alterações no processo de instalação.

Comandos da CLI de instalação para o serviço de migração

Todos os comandos da CLI começam com az postgres flexible-server migration. Também há instruções de ajuda fornecidas para ajudá-lo a entender as várias opções e enquadrar a sintaxe correta para os comandos da CLI.

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

az login

Migrar comandos

O serviço de migração fornece os seguintes comandos para ajudá-lo a migrar seus bancos de dados PostgreSQL para o Banco de Dados do Azure para PostgreSQL – Servidor Flexível.

Comando Help

O comando --help na CLI do Azure é uma opção valiosa que fornece documentação detalhada sobre os comandos e seus subcomandos, incluindo os verbos necessários para operações. O comando –-helpexibe os comandos necessários e suas ações associadas para o serviço de migração no Banco de Dados do Azure para PostgreSQL.

az postgres flexible-server migration –-help

A saída orienta você pelas etapas e parâmetros necessários para gerenciar as migrações de banco de dados efetivamente usando a CLI do Azure.

Comando Create

O comando az postgres flexible-server migration create na CLI do Azure é usado para iniciar um novo fluxo de trabalho de migração. Ele facilita a migração de bancos de dados de uma instância PostgreSQL de origem para uma instância do Banco de Dados do Azure de destino para PostgreSQL – Servidor Flexível. Esse comando configura os parâmetros e as configurações necessários para garantir um processo de migração suave e eficiente.

Para obter mais informações, consulte az postgres flexible-server migration create

Comando list

O comando az postgres flexible-server migration list é usado para listar todas as tentativas de migração feitas para um destino do Banco de Dados do Azure para PostgreSQL. Esse comando fornece uma visão geral das migrações que foram iniciadas, permitindo que você acompanhe o status e os detalhes de cada tentativa de migração.

Para obter mais informações, consulte az postgres flexible-server migration list

Comando show

O comando az postgres flexible-server migration show ajuda você a monitorar as migrações em andamento e fornece o estado e o subestado atuais da migração. Esses detalhes incluem informações sobre o estado atual e o subestado da migração.

Para obter mais informações, consulte az postgres flexible-server migration show

Alguns estados de migração possíveis:

Estados de migração

Estadual Descrição
InProgress A instalação da infraestrutura de migração está em andamento ou a migração de dados real está em andamento.
Cancelada A migração foi cancelada ou excluída.
Com falha A migração falhou.
Falha na Validação A validação falhou.
Êxito A migração foi bem-sucedida e está concluída.
WaitingForUserAction Aplicável somente para migração online. Aguardando a ação do usuário para executar a substituição.

Subestados de migração

Subestado Descrição
PerformingPreRequisiteSteps A configuração da infraestrutura está em andamento para migração de dados.
Validação em andamento Validação em andamento.
MigratingData Migração de dados em andamento.
CompletingMigration A migração está nos estágios finais da conclusão.
Concluído A migração foi concluída.
Com falha A migração falhou.

Substratos de validação

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

Comando Update

O comando az postgres flexible-server migration update é usado para gerenciar o processo de migração para um Servidor Flexível do Banco de Dados do Azure para PostgreSQL. Especificamente, ele pode ser usado para:

  • Executar uma substituição: isso finaliza o processo de migração alternando o tráfego do banco de dados do servidor de origem para o Servidor Flexível de destino.
    • Após a conclusão da migração de dados base, a tarefa de migração passa para o subestado WaitingForCutoverTrigger. Nesse estado, os usuários podem disparar a substituição do portal selecionando o nome da migração na grade de migração ou por meio da CLI.
    • Antes de iniciar a substituição, é importante garantir que:
      • As gravações na origem são interrompidas
      • O valor de latency diminui para 0 ou perto de 0
      • O valor de latency indica quando o destino foi sincronizado pela última vez com a origem. Neste momento, as gravações na origem podem ser interrompidas e a substituição iniciada. Caso haja tráfego intenso na origem, é recomendável interromper as gravações primeiro para que Latency possa chegar perto de 0 e, em seguida, uma transição seja iniciada.
      • A operação de substituição aplica todas as alterações pendentes da Origem para o Destino e conclui a migração. Se você acionar uma "Cutover" mesmo com um Latency diferente de zero, a replicação será interrompida até esse momento. Todos os dados na fonte até o momento de substituição são aplicados no destino. Digamos que uma latência foi de 15 minutos no ponto de transição, portanto todos os dados alterados nos últimos 15 minutos se aplicam ao destino.
  • Cancelar a migração: se necessário, essa opção permite que você interrompa o processo de migração.
  • Configurar a replicação lógica na origem: é útil quando o servidor de origem é um Banco de Dados do Azure para PostgreSQL – Servidor Único, enquanto prepara o servidor para replicação de dados para o Servidor Flexível.

Para obter mais informações, consulte az postgres flexible-server migration update

Resumo

A tabela a seguir resume os parâmetros usados pelos comandos de migração:

Parâmetro Comandos relevantes Descrição
subscription create, list, show, update ID de assinatura do servidor flexível do PostgreSQL
resource-group create, list, show, update Grupo de recursos do servidor flexível do PostgreSQL
name create, list, show Nome do servidor Flexível do PostgreSQL
migration-name create, show, update Identificador exclusivo das tentativas de migração para o 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 -, e nenhuma das duas migrações para um destino de Servidor Flexível pode ter o mesmo nome.
filter lista Para filtrar migrações, há suporte para dois valores – Ativo e Todos
help create, list, show, update Fornece informações sobre cada comando.
migration-mode create Esse é um parâmetro opcional. Os valores permitidos são – offline, online. Valor padrão: offline.
migration-option create Permite que você execute validações antes de disparar uma migração. O padrão é ValidateAndMigrate. Os valores permitidos são: Migrate, Validate, ValidateAndMigrate.
properties create Caminho absoluto para um arquivo JSON que tem as informações sobre a origem, servidor de destino, bancos de dados para migrar, modos SSL, definindo tipos de origem

Detalhes do arquivo JSON

O comando az postgres flexible-server migration create requer um caminho de arquivo JSON como parte do parâmetro --properties, que contém detalhes de configuração para a migração, como a ID do recurso do servidor de banco de dados de origem, credenciais de administrador, bancos de dados para migrar e outras configurações importantes. Abaixo estão as propriedades diferentes:

Nome da propriedade Descrição
sourceDbServerResourceId Detalhes do servidor de origem no formato para VMs (máquinas virtuais) locais, serviço PostgreSQL baseado em nuvem – <<hostname or IP address>>:<<port>>@<<username>> Se o servidor de origem for o Banco de Dados do Azure para PostgreSQL – servidor único, a ID do recurso estará no formato – /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Esse parâmetro lista senhas para usuários administradores para o servidor de origem e o servidor flexível PostgreSQL de destino. Essas senhas ajudam na autenticação nos servidores de origem e de destino. Ele inclui duas subpropriedades, sourceServerPassword e targetServerPassword
targetServerUserName O valor padrão é o usuário administrador criado durante a criação do servidor flexível de destino PostgreSQL, e a senha fornecida é usada para autenticação nesse usuário.
dbsToMigrate Especifique a lista de bancos de dados que você deseja migrar para o servidor flexível. É possível incluir, no máximo, oito nomes de bancos de dados por vez. Fornecendo a lista de BDs no formato de matriz.
overwriteDBsInTarget Quando definido como true (padrão), se o servidor de destino tiver um banco de dados existente com o mesmo nome que o que você está tentando migrar, o serviço de migração substituirá automaticamente o banco de dados
migrationRuntimeResourceId Necessário se um servidor de runtime precisar ser usado para migração. O formato é - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Parâmetro obrigatório. Os valores podem ser: on-premises, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Modos SSL para migração. O modo SSL para PostgreSQLSingleServer é VerifyFull e Prefer/Require para outros tipos de origem.

Conteúdo relacionado