GSP1084

Visão geral

No Google Cloud, você pode usar o Database Migration Service para migrar bancos de dados PostgreSQL para o AlloyDB para PostgreSQL. Para isso, o AlloyDB exige o uso do acesso a serviços particulares. Esse acesso é implementado como uma conexão de peering de VPC entre sua rede VPC e a rede VPC subjacente do Google Cloud em que seus recursos do AlloyDB residem.

Neste laboratório, você vai migrar um banco de dados independente do PostgreSQL (executado em uma máquina virtual) para o AlloyDB para PostgreSQL usando um job contínuo do Database Migration Service e peering de VPC para conectividade.

A migração de um banco de dados usando o Database Migration Service exige alguma preparação do banco de dados de origem. Essas tarefas já foram concluídas no ambiente de origem, sendo a mais importante a configuração do pacote pglogical na instância de origem.

Após criar e executar o job de migração, confirme que uma cópia inicial do seu banco de dados foi migrada com sucesso para sua instância do AlloyDB para PostgreSQL. Você também vai descobrir como jobs contínuos de migração aplicam atualizações de dados do seu banco de dados de origem à sua instância do AlloyDB para PostgreSQL.

Atividades deste laboratório

Neste laboratório, você vai aprender a configurar um job contínuo do Database Migration Service para migrar bancos de dados de uma instância do PostgreSQL para o AlloyDB para PostgreSQL.

• Verificar os dados na instância de origem para migração
• Criar um perfil para uma conexão de origem para uma instância do PostgreSQL (por exemplo, PostgreSQL independente)
• Criar e iniciar um job contínuo de migração
• Confirmar o carregamento de dados na instância do AlloyDB para PostgreSQL
• Propagar uma atualização em tempo real para a instância do AlloyDB

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

   • O botão Abrir Console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Ativar o Cloud Shell

O Cloud Shell é uma máquina virtual com várias ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud. O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.

2. Clique nas seguintes janelas:

   • Continue na janela de informações do Cloud Shell.
   • Autorize o Cloud Shell a usar suas credenciais para fazer chamadas de APIs do Google Cloud.

Depois de se conectar, você verá que sua conta já está autenticada e que o projeto está configurado com seu Project_ID, . A saída contém uma linha que declara o projeto PROJECT_ID para esta sessão:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

3. (Opcional) É possível listar o nome da conta ativa usando este comando:

gcloud auth list

4. Clique em Autorizar.

Saída:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Opcional) É possível listar o ID do projeto usando este comando:

gcloud config list project

Saída:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Observação: consulte a documentação completa da gcloud no Google Cloud no guia de visão geral da gcloud CLI.

Tarefa 1: verificar os dados na instância de origem para migração

Verificar os dados na instância de origem

Nesta etapa, você vai se conectar e verificar os dados no banco de dados postgres na instância de VM pg14-source.

1. No Menu de navegação (), em Compute Engine, clique em Instâncias de VM.

2. Na instância chamada pg14-source, na coluna Conectar, clique em SSH para abrir uma janela do terminal.

3. Use o comando a seguir para iniciar o cliente PostgreSQL (psql).

sudo -u postgres psql

4. Você vai receber o prompt do terminal psql, semelhante ao mostrado abaixo.

psql (14.5 (Debian 14.5-1.pgdg110+1)) Type "help" for help.

5. Insira e execute o seguinte comando SQL para ver as tabelas relacionadas a RH no banco de dados postgres.

\dt

6. Execute as consultas a seguir para determinar as contagens de linhas de cada tabela.

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

7. As contagens de linhas da tabela de origem são as seguintes.

Nome	Linhas
países	25
departamentos	27
funcionários	107
jobs	19
locais	23
regiões	4

8. Digite \q para sair do cliente psql.

9. Digite exit para fechar a janela do terminal.

Tarefa 2: criar um perfil de conexão no Database Migration Service para um banco de dados independente PostgreSQL

Nesta tarefa, você criará um perfil de conexão para a instância de origem do PostgreSQL.

Obter as informações de conectividade e implantação da instância de origem do PostgreSQL

Nesta etapa, você vai identificar o endereço IP interno da instância do banco de dados de origem que será migrado para o AlloyDB.

1. No Menu de navegação (), em Compute Engine, clique em Instâncias de VM.

2. Encontre a linha da instância pg14-source.

3. Copie o valor do IP interno (por exemplo, 10.128.15.208).

Criar um novo perfil de conexão para a instância de origem do PostgreSQL

Um perfil de conexão guarda informações sobre a instância do banco de dados de origem (por exemplo, PostgreSQL independente) e é usado pelo Database Migration Service para migrar dados da origem para a instância de destino do AlloyDB para PostgreSQL. Uma vez que o perfil de conexão é criado, ele pode ser reutilizado em todos os jobs de migração.

Nesta etapa, você criará um novo perfil de conexão para a instância de origem do PostgreSQL.

1. No console do Google Cloud, no Menu de navegação (), clique em Ver todos os produtos. Na seção Bancos de dados, clique em Migração de banco de dados > Perfis de conexão.

2. Clique em + Criar perfil.

3. Em Papel do perfil, selecione Origem.

4. Em Mecanismo de banco de dados, selecione PostgreSQL.

5. Em Nome do perfil de conexão, digite pg14-source.

6. Em Região, selecione .

7. Em Definir configurações de conexão, clique em DEFINIR

8. Em Nome do host ou endereço IP, digite o IP interno para a instância de origem do PostgreSQL que você copiou na tarefa anterior (por exemplo, 10.128.15.208)

9. Em Porta, digite 5432.

10. Em Nome de usuário, insira postgres.

11. Em Senha, digite Change3Me.

12. Mantenha os valores padrão dos outros campos.

13. Clique em Salvar.

14. Clique em Criar.

Um novo perfil de conexão chamado pg14-source vai aparecer na lista de perfis de Conexão.

12. Clique em Verificar meu progresso para conferir o objetivo. Crie um perfil de conexão para a instância de origem do PostgreSQL

Tarefa 3: criar e iniciar um job contínuo de migração

Ao criar um novo job de migração, primeiro é necessário definir a instância do banco de dados de origem usando um perfil de conexão criado anteriormente. Depois disso, crie uma nova instância de banco de dados de destino e configure a conectividade entre as instâncias de origem e de destino.

Nesta tarefa, você vai usar a interface do job de migração para criar um novo cluster do AlloyDB para PostgreSQL e o definir como o destino do job contínuo de migração da instância de origem do PostgreSQL.

Criar um novo job contínuo de migração

Nesta etapa, você vai criar um novo job contínuo de migração.

1. No console do Google Cloud, no Menu de navegação (), clique em Ver todos os produtos. Na seção Bancos de dados, clique em Migração de banco de dados > Jobs de migração.

2. Clique em + Criar job de migração.

3. Em Nome do job de migração, digite postgres-to-alloydb.

4. Em Mecanismo de banco de dados de origem, selecione PostgreSQL.

5. Em Mecanismo de banco de dados de destino, selecione AlloyDB para PostgreSQL.

6. Em Região de destino, selecione .

7. No momento, Contínuo é a única opção disponível em Tipo de job de migração para PostgreSQL para AlloyDB.

8. Mantenha os valores padrão das outras configurações.

9. Clique em Salvar e continuar.

Definir a instância de origem

Nesta etapa, você vai definir a instância de origem para a migração.

1. Em Selecionar perfil de conexão de origem, selecione o perfil de conexão pg14-source que você criou há algumas etapas.

2. Clique em Salvar e continuar.

Criar a instância de destino

Nesta etapa, o assistente do DMS vai criar o cluster e a instância do AlloyDB em seu nome.

1. Em Tipo de cluster de destino, a opção Novo cluster já está selecionada.

2. Clique em Continuar para Revisar a configuração do cluster.

3. Em ID do cluster, digite alloydb-target-cluster.

4. Em Senha, digite Change3Me.

5. Em Rede, selecione peering-network.

6. Clique em Continuar.

7. Em ID da instância, digite alloydb-target-instance.

8. Selecione 2 vCPUs, 16 GB como tipo de máquina.

9. Clique em Salvar e continuar.

10. Na janela pop-up, clique em Criar destino e continuar para continuar.

11. Enquanto a instância e o cluster do AlloyDB são criados, você pode escolher Peering de VPC na lista de opções do Método de conectividade.

12. Aguarde até que o cluster e a instância sejam concluídos. O link Configurar e continuar vai ficar disponível quando o banco de dados também estiver disponível.

13. Clique em Configurar e continuar.

14. Na página Selecionar objetos a serem migrados, em Bancos de dados a serem migrados, selecione Todos os bancos de dados.

15. Clique em Salvar e continuar.

Testar e iniciar o job contínuo de migração

Nesta etapa, você vai testar e iniciar o job de migração.

1. O assistente do Database Migration Service agora está na etapa Testar e criar seu job de migração.

2. Clique em Job de teste.

3. Após um teste bem-sucedido, clique em Criar e iniciar job.

Observação: você precisa clicar em Criar e iniciar job para que o job comece. O outro link apenas cria e salva os detalhes do job.

Se precisar confirmar, clique em Criar e iniciar.

Revisar o status do job contínuo de migração

Nesta etapa, você vai confirmar se o job contínuo de migração está sendo executado.

1. No console do Google Cloud, no Menu de navegação (), clique em Ver todos os produtos. Na seção Bancos de dados, clique em Migração de banco de dados > Jobs de migração.

2. Clique no job de migração postgres-to-alloydb para ver a página de detalhes.

3. Revise o status do job de migração.

• Se job não tiver sido iniciado, o status será Não iniciado. Você poderá escolher iniciar ou excluir o job.
• Após o início do job, o status será Iniciando e depois, Em execução Despejo completo em andamento para indicar que o despejo inicial do banco de dados está em andamento.
• O status do job vai mudar para Em execução CDC em andamento quando o carregamento inicial for concluído e o DMS estiver disponível para operações contínuas.

Quando o status do job mudar para Em execução CDC em andamento, prossiga para a próxima tarefa.

Tarefa 4: confirmar o carregamento de dados na instância do AlloyDB para PostgreSQL

Verifique a instância do AlloyDB para PostgreSQL

1. No menu de navegação do console do Cloud (), clique em Ver todos os produtos. Na seção Bancos de dados, clique em AlloyDB para PostgreSQL e em Clusters para examinar os detalhes do cluster.

2. O cluster é chamado de alloydb-target-cluster e a instância é chamada de alloydb-target-cluster-primary.

3. Anote o endereço IP privado na seção de instâncias. Copie o endereço de IP privado em um arquivo de texto para colar o valor em uma etapa posterior.

4. No Menu de navegação (), em Compute Engine, clique em Instâncias de VM.

5. Na instância chamada alloydb-client, na coluna Conectar, clique em SSH para abrir uma janela do terminal.

6. Defina a seguinte variável de ambiente, substituindo ALLOYDB_ADDRESS pelo endereço IP privado da instância do AlloyDB.

export ALLOYDB=ALLOYDB_ADDRESS

7. Execute o comando a seguir para armazenar o endereço IP privado da instância do AlloyDB na VM do cliente do AlloyDB para que ele persista durante todo o laboratório.

echo $ALLOYDB > alloydbip.txt

8. Conecte-se ao cliente psql e execute a consulta a seguir para verificar se as cinco tabelas de origem estão agora na instância do AlloyDB. Será necessário fornecer a senha do usuário postgres (Change3Me), que foi especificada quando o cluster foi criado.

psql -h $ALLOYDB -U postgres \dt List of relations Schema | Name | Type | Owner --------+-------------+-------+--------------------- public | countries | table | alloydbexternalsync public | departments | table | alloydbexternalsync public | employees | table | alloydbexternalsync public | jobs | table | alloydbexternalsync public | locations | table | alloydbexternalsync public | regions | table | alloydbexternalsync (6 rows)

9. Execute as consultas a seguir para determinar as contagens de linhas das tabelas migradas. Os valores vão corresponder às saídas de consulta na instância de origem.

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

10. As contagens de linhas da tabela de destino são as seguintes.

Nome	Linhas
países	25
departamentos	27
funcionários	107
jobs	19
locais	23
regiões	4

11. Execute a consulta a seguir para verificar os dados na tabela de regiões.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa (4 rows) .

Tarefa 5: propagar uma atualização em tempo real para a instância do AlloyDB

1. Como o job do Database Migration Service está definido em uma configuração de atualização contínua, todas as atualizações feitas na instância de origem serão aplicadas ao destino do AlloyDB.

2. No Menu de navegação (), em Compute Engine, clique em Instâncias de VM.

3. Na instância chamada pg14-source, na coluna Conectar, clique em SSH para abrir uma janela do terminal.

4. Use o comando a seguir para iniciar o cliente PostgreSQL (psql).

sudo -u postgres psql

5. O prompt do terminal psql será exibido. Insira e execute o seguinte comando SQL para adicionar uma linha de dados à tabela de regiões.

insert into regions values (5, 'Oceania');

6. Confirme se a linha foi inserida localmente.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

Revisar os dados na instância do AlloyDB para PostgreSQL

1. Volte ao shell do terminal de alloydb-client. O cliente psql ainda estará aberto. Execute a consulta a seguir para verificar se a linha Oceania foi adicionada à instância de destino do AlloyDB.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

2. Clique em Verificar meu progresso para conferir o objetivo. Testar a migração contínua de dados

Parabéns!

Você migrou com sucesso um banco de dados PostgreSQL independente (em execução em uma máquina virtual) para o AlloyDB para PostgreSQL usando um job contínuo do Database Migration Service.

Manual atualizado em 14 de fevereiro de 2025

Laboratório testado em 14 de fevereiro de 2025

Copyright 2025 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.