Partilhar via

Como configurar a CLI do Azure para o serviço de migração no Banco de Dados do Azure para servidor flexível PostgreSQL

A CLI do Azure é um conjunto de comandos usados nos serviços do Azure para criar e gerenciar recursos. Ele fornece os mesmos recursos que o portal do Azure, mas é otimizado 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 sua máquina local.

Prerequisites

  • Instalar a CLI do Azure: Dependendo do seu sistema operacional, baixe e instale a CLI do Azure. Está disponível para Windows, macOS e 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 sua 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 sua versão atual.

  • Entre 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 o serviço de migração no Banco de Dados do Azure para PostgreSQL de forma eficaz. Consulte sempre a documentação mais recente do Azure para obter quaisquer atualizações ou alterações ao processo de instalação.

Configurar comandos da CLI para o serviço de migração

Todos os comandos da CLI começam com az postgres flexible-server migration. Há também 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.

Etapas para configurar comandos da CLI

  1. Instalar a 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.

  2. Verifique a versão da CLI do Azure: verifique se a versão da CLI do Azure é pelo menos 2.56.0 ou superior. Use o comando az --version para verificar sua versão atual.

  3. Entre 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.

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

az login

Migrar comandos

O serviço de migração fornece os seguintes comandos para ajudá-lo a migrar suas instâncias do PostgreSQL para o Banco de Dados do Azure para o servidor flexível do PostgreSQL.

Comando de Ajuda

O --help comando 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 –-helpcomando exibe 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 suas migrações de banco de dados de forma eficaz usando a CLI do Azure.

Criar Comando

O az postgres flexible-server migration create comando na CLI do Azure é usado para iniciar um novo fluxo de trabalho de migração. Facilita a migração de bases de dados de uma instância PostgreSQL de origem para uma instância de servidor flexível do Azure Database for PostgreSQL de destino. Este comando define os parâmetros e 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 de Listagem

O az postgres flexible-server migration list comando é usado para listar todas as tentativas de migração feitas para um Banco de Dados do Azure para destino PostgreSQL. Este 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 de Exibição

O az postgres flexible-server migration show comando ajuda a monitorar as migrações em curso e fornece o estado atual e o subestado 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

State Description
InProgress A configuração da infraestrutura de migração está em andamento ou a migração de dados real está em andamento.
Canceled A migração é cancelada ou excluída.
Failed A migração falhou.
Falha na validação A validação falhou.
Succeeded A migração foi bem-sucedida e está concluída.
WaitingForUserAction Aplicável apenas para migração online. Aguardando a ação do usuário para executar a substituição.

Subestados de migração

Substate Description
PerformingPreRequisiteSteps A configuração da infraestrutura está em andamento para a migração de dados.
Validação em Curso A validação está em curso.
MigratingData A migração de dados está em andamento.
CompletingMigration A migração está em fase final de conclusão.
Completed A migração está concluída.
Failed Falha na migração.

Subestados de validação

Substate Description
Failed A validação falhou.
Succeeded A validação foi bem-sucedida.
Warning A validação está em alerta.

Comando de Atualização

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

  • Executar um cutover: isto finaliza o processo de migração ao redirecionar 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 é movida para o WaitingForCutoverTrigger subestado. Nesse estado, os usuários podem acionar a substituição do portal selecionando o nome da migração na grade de migração ou por meio da CLI.
    • Antes de iniciar o corte, é importante garantir que:
      • As gravações na fonte são interrompidas
      • latency o valor diminui para 0 ou perto de 0
      • latency value indica quando o destino foi sincronizado pela última vez com a origem. Neste ponto, as gravações na fonte podem ser interrompidas e a transferência iniciada. No caso de haver tráfego intenso na origem, deve-se parar as gravações primeiro para que Latency possa ficar próximo de 0, e, em seguida, é iniciada uma transição.
      • 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 "Substituição" mesmo com diferente de zero Latency, a replicação será interrompida até esse momento. Todos os dados na origem até o ponto de transição são então aplicados no destino. Digamos que uma latência foi de 15 minutos no ponto de transferência, portanto, todos os dados alterados nos últimos 15 minutos se aplicam ao alvo.

  • Cancelar a migração: se necessário, esta opção permite interromper o processo de migração.

  • Configurar a replicação lógica na origem: isso é útil quando o servidor de origem é um Banco de Dados do Azure para PostgreSQL - Servidor Único, pois prepara o servidor para a replicação de dados para o servidor flexível.

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

Summary

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

Parameter Comandos relevantes Description
subscription criar, listar, mostrar, atualizar ID de assinatura do servidor flexível PostgreSQL
resource-group criar, listar, mostrar, atualizar Grupo de recursos do servidor flexível PostgreSQL
name criar, listar, mostrar Nome do servidor PostgreSQL Flexible
migration-name criar, mostrar, atualizar Identificador exclusivo para as migrações tentadas para 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 -, e não há duas migrações para um destino de servidor flexível que possam ter o mesmo nome.
filter list Para filtrar migrações, há suporte para dois valores – Ativo e Todos
help criar, listar, mostrar, atualizar Fornece informações sobre cada comando.
migration-mode criar Este é um parâmetro opcional. Os valores permitidos são - offline, online. Valor padrão: Offline.
migration-option criar Permite executar validações antes de acionar uma migração. O padrão é ValidateAndMigrate. Os valores permitidos são - Migrate, Validate, ValidateAndMigrate.
properties criar Caminho absoluto para um arquivo JSON que tem as informações sobre a origem, servidor de destino, bancos de dados a migrar, modos SSL, definição de tipos de origem

Detalhes do arquivo JSON

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

Nome da propriedade Description
sourceDbServerResourceId Detalhes do servidor de origem no formato para máquinas virtuais (VMs) 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 Este parâmetro lista senhas para usuários administradores para o servidor de origem e o servidor flexível PostgreSQL de destino. Essas senhas ajudam a autenticar nos servidores de origem e de destino. Inclui duas subpropriedades, sourceServerPassword e targetServerPassword
targetServerUserName O valor padrão é o usuário admin criado durante a criação do servidor flexível de destino PostgreSQL, e a senha fornecida é usada para autenticação contra esse usuário.
dbsToMigrate Especifique a lista de bancos de dados que você deseja migrar para o servidor flexível. Você pode incluir um máximo de oito nomes de banco de dados por vez. Fornecendo a lista de bancos de dados em 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 daquele que você está tentando migrar, o serviço de migração substituirá automaticamente o banco de dados
migrationRuntimeResourceId Necessário se um servidor de tempo de execução precisar ser usado para migração. O formato é: /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName Necessário somente se a origem for um servidor único e estiver atrás de um servidor DNS personalizado, namespaces DNS personalizados, FQDN personalizado ou precisar ser acessível via IP.
targetDBServerFullyQualifiedDomainName Necessário somente se o destino estiver atrás de um servidor DNS personalizado, de namespaces DNS personalizados, de um FQDN personalizado, ou se precisar ser acessível via IP.
sourceType Parâmetro necessá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 fonte.

Conteúdo relacionado

  • Last updated on