Partilhar 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 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.

Pré-requisitos

  • 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.

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 suas instâncias do PostgreSQL para o Banco de Dados do Azure para PostgreSQL - Servidor Flexível.

Comando 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.

Comando Criar

O az postgres flexible-server migration create comando 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 do PostgreSQL de origem para um Banco de Dados do Azure de destino para PostgreSQL - instância do Servidor Flexível. 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 Lista

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 Mostrar

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

Condição Description
Em curso 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 é cancelada ou excluída.
Falhado A migração falhou.
Falha na validação A validação falhou.
Bem sucedido 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

Subestado Description
ExecutandoPreRequirementseSteps A configuração da infraestrutura está em andamento para a migração de dados.
Validação em Curso A validação está em curso.
MigrandoData A migração de dados está em andamento.
ConcluindoMigração A migração está em fase final de conclusão.
Concluído A migração foi concluída.
Falhado A migração falhou.

Subestados de validação

Subestado Description
Falhado A validação falhou.
Bem sucedido A validação foi bem-sucedida.
Aviso A validação está em alerta.

Comando Atualizar

O az postgres flexible-server migration update comando é usado para gerenciar o processo de migração para um Banco de Dados do Azure para o Servidor Flexível 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 é 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, recomenda-se parar as gravações primeiro para que Latency possa chegar perto de 0 e, em seguida, uma substituição é 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 "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 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 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 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 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 nenhuma migração para um destino de Servidor Flexível pode 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. Abaixo estão as diferentes propriedades:

Nome de 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 DBs 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>>
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údos relacionados