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. Neste ambiente de laboratório, você implementa esse acesso 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. Em seguida, 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.

Para migrar um banco de dados usando o Database Migration Service, é necessário realizar algumas etapas para preparar o banco de dados de origem. Essas tarefas preparatórias, principalmente a configuração do pacote pglogical, já foram concluídas para você no ambiente 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 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. Isso envolve:

• 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

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

Verificar os dados na instância de origem

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 este comando para iniciar o cliente PostgreSQL (psql):

sudo -u postgres psql

O prompt do terminal psql é aberto. Ele parece com este prompt:

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

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

\dt

5. Execute estas consultas para determinar o número 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;

Estas são as contagens de linhas da tabela de origem:

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

6. Digite \q para sair do cliente psql.

7. 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ê vai 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

Você precisa do endereço IP interno da instância do banco de dados de origem para migrar o banco de dados para o AlloyDB.

1. Ainda na página "Instâncias de VM", localize a instância pg14-source.

2. Registre o 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 armazena informações sobre a instância do banco de dados de origem (por exemplo, PostgreSQL independente). O Database Migration Service usa o perfil de conexão para migrar dados do banco de dados de origem para o de destino. Depois de criar um perfil de conexão, ele pode ser reutilizado em todos os jobs de migração

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

1. No console do Google Cloud, acesse o Menu de navegação () e clique em Ver todos os produtos.

2. Na categoria Bancos de dados, clique em Migração de banco de dados.

3. No painel à esquerda, clique em Perfis de conexão e Criar perfil.

4. Defina os campos a seguir conforme mostrado abaixo. Mantenha os valores padrão em todos os outros campos.

Campos	Valor
Mecanismo de origem	PostgreSQL
Mecanismo de destino	Cloud SQL para PostgreSQL
Escolha o tipo de perfil a ser criado	Origem
Nome do perfil de conexão	pg14-origem
Região
PostgreSQL para PostgreSQL	Clique em Definir
PostgreSQL para PostgreSQL	Insira o IP interno da instância de origem do PostgreSQL que você registrou (por exemplo, 10.128.15.208)
Porta	5432
Nome de usuário	postgres
Senha	Change3Me

5. Clique em Salvar.

6. Clique em Criar.

O novo perfil de conexão pg14-source aparece na lista de perfis de conexão.

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. 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. Ainda na página de migração de banco de dados, clique em Jobs de migração no painel à esquerda.

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

Primeiros passos

1. Defina os campos a seguir e deixe todas as outras configurações como padrão.

Campo	Valor
Nome do job de migração	postgres-to-alloydb
Mecanismo do banco de dados de origem	PostgreSQL
Mecanismo de banco de dados de destino	AlloyDB para PostgreSQL
Região de destino

2. Clique em Salvar e continuar.

Definir uma origem

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

2. Clique em Salvar e continuar.

Definir um destino

1. Em Tipo de cluster de destino, selecione Cluster atual.

2. Em ID do cluster, selecione alloydb-target-cluster.

3. Clique em Selecionar e continuar.

4. Quando solicitado, digite alloydb-target-cluster para confirmar e clique em Confirmar e continuar.

Definição do método de conectividade

1. Em Método de conectividade, selecione Peering de VPC.

2. Clique em Configurar e continuar.

Configurar bancos de dados de migração

1. Defina Bancos de dados a serem migrados como Todos os bancos de dados.

2. Clique em Salvar e continuar.

Testar e criar um 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, 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.

4. Se precisar confirmar, clique em Criar e iniciar.

A página de detalhes de postgres-to-alloydb é aberta.

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

1. Na página de detalhes do postgres-to-alloydb, revise o Status do job de migração.

• Se o 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 para indicar que o despejo inicial do banco de dados está em andamento.
• O status do job muda para Em execução e a fase é CDC quando o carregamento inicial é concluído e o DMS está disponível para operações contínuas.

2. Quando o status do job mudar para Em execução e a fase for CDC, 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 console do Google Cloud, acesse o Menu de navegação () e clique em Ver todos os produtos. Na categoria Bancos de dados, clique em AlloyDB para PostgreSQL e em Clusters para examinar a lista de clusters.

O cluster é chamado de alloydb-target-cluster, e a instância é chamada de alloydb-target-instance.

2. Clique em alloydb-target-cluster e, no painel à esquerda, clique em Conectividade.

3. Registre o endereço IP particular, por exemplo, 10.24.0.2.

Se você clicar em Copiar para a área de transferência para copiar o endereço IP particular, o número da porta será incluído. Por exemplo, 10.24.0.2:5432. Registre apenas o endereço IP, por exemplo, 10.24.0.2, para usar em uma etapa posterior.

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

5. Na instância alloydb-client, 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 (por exemplo, 10.24.0.2):

export ALLOYDB=[ALLOYDB_ADDRESS]

7. Execute este comando 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. Quando solicitado, forneça 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;

Estas são as contagens de linhas da tabela de destino:

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

10. 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) .

Deixe essa janela do terminal aberta para usar na próxima seção.

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

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

1. Volte para o console do Google Cloud.

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

3. Use este comando para iniciar o cliente PostgreSQL (psql):

sudo -u postgres psql

4. No prompt do terminal psql, insira e execute este comando SQL para adicionar uma linha de dados à tabela regions:

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

5. Confirme que 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 permanece 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 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.

Próximas etapas / Saiba mais

Saiba mais sobre migração de dados, bancos de dados do Cloud SQL e o Database Migration Service:

• Documentação do Database Migration Service
• Documentação sobre a migração para o AlloyDB para PostgreSQL

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 15 de dezembro de 2025

Laboratório testado em 24 de novembro de 2025

Copyright 2026 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.