- Rebaixamento de cluster: o Database Migration Service rebaixa o cluster de destino para configurá-lo como uma réplica do banco de dados de origem.
- Evite operações de gravação em dados de migração: não realize operações de gravação
(como
INSERT,UPDATE,DELETEou alterações de esquema DDL) no cluster de destino em tabelas ou bancos de dados incluídos na migração. Essas operações podem levar a conflitos de replicação com dados provenientes da origem. - Gerenciar usuários do banco de dados: é possível criar e gerenciar usuários do banco de dados
a qualquer momento usando comandos
psqlpadrão ou pelo AlloyDB para PostgreSQL no console do Google Cloud . Para mais informações, consulte Gerenciar usuários do banco de dados na documentação do AlloyDB para PostgreSQL.
Para mais informações, consulte Limitações conhecidas para clusters de destino atuais.
O Database Migration Service usa jobs de migração para migrar dados do banco de dados de origem para o cluster de destino do AlloyDB para PostgreSQL. A criação de um job de migração para um cluster de destino atual inclui:
- Definir configurações para o job de migração
- Definir as configurações de origem e selecionar os bancos de dados a serem migrados
- Selecionar o cluster de destino do AlloyDB para PostgreSQL
- Rebaixando o cluster atual para configurá-lo como uma réplica do banco de dados de origem
- Configurar a conectividade entre os bancos de dados de origem e de destino
- Testar o job de migração para garantir que as informações de conexão fornecidas sejam válidas.
Antes de começar
Antes de criar um job de migração para um cluster de destino do AlloyDB para PostgreSQL, verifique se você:
- Verifique se esse tipo de migração é compatível com seu cenário. Por exemplo, quando você quer migrar para um cluster criado fora do Database Migration Service, o cluster de destino do AlloyDB para PostgreSQL precisa estar vazio ou conter apenas dados de configuração do sistema. Para mais detalhes, consulte Limitações conhecidas.
Crie o cluster de destino do AlloyDB para PostgreSQL e a instância principal dele. Consulte Criar um cluster e a instância principal dele na documentação do AlloyDB para PostgreSQL.
- Prepare a instância do banco de dados de origem. Consulte as seguintes páginas:
Para criar um job de migração para um cluster de destino, faça o seguinte:
Console
Definir configurações para o job de migração
- No console do Google Cloud , acesse a página Jobs de migração.
- Clique em Criar job de migração.
A página do assistente de configuração do job de migração é aberta. Esse assistente contém vários painéis que orientam você em cada etapa da configuração.
É possível pausar a criação de um job de migração a qualquer momento clicando em Salvar e sair. Todos os dados inseridos até esse ponto são salvos em um job de migração de rascunho. Você pode concluir o rascunho do job de migração mais tarde.
- Na página Começar, insira as seguintes informações:
- Nome do job de migração
Este é um nome legível por humanos para o job de migração. Esse valor é exibido no console do Google Cloud .
- ID da tarefa de migração
Este é um identificador legível por máquina para o job de migração. Use esse valor para trabalhar com jobs de migração usando os comandos da CLI do Google Cloud ou a API do Database Migration Service.
- Na lista Mecanismo de banco de dados de origem, selecione PostgreSQL.
- Na lista Mecanismo de banco de dados de destino, selecione AlloyDB para PostgreSQL.
- Selecione a região em que você salvou o job de migração.
O Database Migration Service é um produto totalmente regional, o que significa que todas as entidades relacionadas à migração (perfis de conexão de origem e destino, jobs de migração, clusters de destino) precisam ser salvas em uma única região. Selecione a região em que o cluster de destino está localizado. Depois de escolher a região de destino, não será possível mudar essa seleção.
- Escolha Contínuo (snapshot + alterações em andamento) como o tipo de serviço de migração. As migrações homogêneas para o AlloyDB para PostgreSQL são compatíveis exclusivamente com migrações contínuas.
- Nome do job de migração
- Clique em Salvar e continuar.
Especificar informações sobre o perfil de conexão de origem
Na página Definir uma origem, siga estas etapas:
- No menu suspenso Perfil de conexão de origem, selecione o perfil de conexão do banco de dados de origem.
- Na seção Personalizar as configurações de paralelismo,
clique em Mostrar as configurações de paralelismo.
Durante o despejo completo inicial, a extensão
pglogicalreplica dados no nível da tabela e não divide uma tabela individual não particionada, uma partição de folha ou uma tabela sem uma chave primária em várias assinaturas. Isso significa que o paralelismo de despejo de dados aprimorado não pode aumentar a velocidade de despejo inicial de uma única tabela grande não particionada, porque essa tabela é copiada em uma assinatura. Para mais informações, consulte Considerações sobre o paralelismo de despejo de dados.A velocidade do paralelismo de despejo de dados está relacionada à quantidade de carga induzida no banco de dados de origem:
- Ideal (recomendado): desempenho equilibrado com carga ideal no banco de dados de origem. O Database Migration Service cria até duas assinaturas por banco de dados (até duas no total em todos os bancos de dados, com pelo menos uma assinatura por banco de dados migrado).
- Máximo: fornece as velocidades de despejo mais altas, mas pode causar um aumento da carga no banco de dados de origem. O Database Migration Service cria até 4 assinaturas por banco de dados (até 4 no total em todos os bancos de dados, com pelo menos 1 assinatura por banco de dados migrado).
- Mínimo: usa a menor quantidade de recursos de computação no banco de dados de origem, mas pode ter uma capacidade de despejo mais lenta. O Database Migration Service cria uma assinatura por banco de dados.
Se você escolher configurações ajustadas de paralelismo de despejo de dados, aumente os parâmetros
max_replication_slots,max_wal_sendersemax_worker_processesno banco de dados de origem. - Clique em Salvar e continuar.
Selecione o cluster de destino do AlloyDB para PostgreSQL
- No menu Tipo de instância de destino, selecione Cluster atual.
- Na seção Selecionar cluster de destino, selecione o cluster de destino do AlloyDB para PostgreSQL.
-
Revise as informações na seção Detalhes do cluster e clique em Selecionar e continuar.
Para migrar para um banco de dados de destino, o Database Migration Service rebaixa o cluster de destino e o configura como uma réplica. Para indicar que o rebaixamento pode ser realizado com segurança, na janela de confirmação, insira o identificador do cluster de destino.
- Clique em Confirmar e continuar.
Configurar a conectividade entre a instância do banco de dados de origem e o cluster de destino
No menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como o cluster de destino do AlloyDB para PostgreSQL se conecta ao banco de dados de origem. Os métodos atuais de conectividade de rede incluem lista de permissões de IP, túnel SSH reverso, interfaces do Private Service Connect, peering de VPC e proxy TCP por uma VM hospedada na nuvem.
| Se você quiser usar… | Faça o seguinte: |
|---|---|
| O método de conectividade de rede de lista de permissões de IP, | Copie os dois endereços IP públicos de saída da instância principal do cluster de destino e use-os para configurar o firewall de rede do servidor de banco de dados de origem e no arquivo pg_hba.conf. |
| O método de conectividade de rede de túnel SSH reverso, | Selecione a instância de VM do Compute Engine que vai hospedar o túnel.
Depois de especificar a instância, o Google fornece um script que executa as etapas para configurar o túnel entre os bancos de dados de origem e destino. Execute o script na Google Cloud CLI em uma máquina que tenha conectividade com o banco de dados de origem e com o Google Cloud. |
| O método de conectividade de interfaces do Private Service Connect, | O Database Migration Service estabelece automaticamente as conexões necessárias. Esse método de conectividade só estará disponível se você tiver um cluster de destino ativado para o Private Service Connect com um anexo de rede. Para mais informações sobre o Private Service Connect, consulte Configurar o Private Service Connect na documentação do AlloyDB para PostgreSQL. |
| O método de conectividade de rede de peering de VPC, | Selecione a rede VPC em que o banco de dados de origem está localizado. O cluster do AlloyDB para PostgreSQL se conecta a essa rede usando o acesso a serviços particulares. |
| O proxy TCP por meio de um método de conectividade de VM hospedada na nuvem, | Insira os detalhes necessários para a nova instância de VM do Compute Engine que vai hospedar o proxy TCP.
Depois de especificar os detalhes, o console do Google Cloud fornece um script que configura o proxy entre os bancos de dados de origem e de destino. Execute o script em uma máquina com uma Google Cloud CLI atualizada. Depois de executar o script, insira o endereço IP particular da VM recém-criada e clique em Configurar e continuar. |
Depois de selecionar e configurar a conectividade de rede, clique em Configurar e continuar.
Configurar bancos de dados de migração
É possível migrar todos os bancos de dados da instância de origem ou escolher apenas bancos de dados específicos.
- Na lista Bancos de dados a serem migrados, selecione uma das seguintes opções:
- Todos os bancos de dados: seleciona todos os bancos de dados que existem na origem.
- Bancos de dados específicos: permite selecionar bancos de dados específicos entre todos os que existem na origem.
Se quiser migrar bancos de dados específicos, filtre a lista que aparece e selecione os bancos de dados que você quer que o Database Migration Service migre para o destino.
Se a lista não aparecer e um erro de descoberta de banco de dados for exibido, clique em Atualizar. Se a descoberta de banco de dados falhar, o job vai migrar todos os bancos de dados. Você pode continuar criando um job de migração e corrigir os erros de conectividade mais tarde.
- Clique em Salvar e continuar.
Testar, criar e executar o job de migração
Nesta etapa final, revise o resumo das configurações do job de migração, da origem, do destino e do método de conectividade e teste a validade da configuração do job de migração. Se houver problemas, modifique as configurações do job de migração. Nem todas as configurações são editáveis.
- Na página Testar e criar job de migração, clique em Testar job.
Se o teste falhar, resolva o problema na parte do fluxo destinada a isso e refaça o teste. Para informações sobre como resolver problemas em um teste de job de migração com falha, consulte Diagnosticar problemas do AlloyDB para PostgreSQL.
- Quando o teste do job de migração terminar, clique em Criar e iniciar job
para criar o job de migração e iniciá-lo imediatamente ou clique em Criar job
para criar o job de migração sem iniciá-lo imediatamente.
Se o job não for iniciado no momento da criação, ele poderá ser iniciado na página Jobs de migração clicando em Iniciar. Independentemente de quando o job de migração começar, sua organização será cobrada pela existência do cluster de destino.
Sua migração está em andamento. Quando você inicia o job de migração, o Database Migration Service começa o despejo completo inicial e a replicação contínua. Para mais informações, consulte Limitações conhecidas.
- Prossiga para Revisar o job de migração.
CLI do Google Cloud
Ao migrar para um cluster atual usando a Google Cloud CLI, é necessário criar manualmente o perfil de conexão para o cluster de destino. Isso não é necessário ao usar o console do Google Cloud , já que o Database Migration Service cuida da criação e remoção do perfil de conexão de destino para você.
Crie o perfil de conexão de destino.
Crie o perfil de conexão de destino para o cluster de destino atual executando o comandogcloud database-migration connection-profiles create(clique no link para expandir):gcloud database-migration connection-profiles create postgresqlEste exemplo usa a flag opcional
--no-asyncpara que todas as operações sejam realizadas de forma síncrona. Isso significa que alguns comandos podem levar um tempo para serem concluídos. É possível pular a flag--no-asyncpara executar comandos de forma assíncrona. Se você fizer isso, use o comandogcloud database-migration operations describepara verificar se a operação foi bem-sucedida.Antes de usar os dados do comando abaixo, faça estas substituições:
- DEST_CONN_ID pelo identificador do perfil de conexão de destino.
- REGION pela região em que você quer salvar o perfil de conexão. Essa região precisa ser a mesma do cluster de destino.
- DEST_CLUSTER pelo ID do cluster de destino do AlloyDB para PostgreSQL pré-criado.
- DEST_USER pelo nome do usuário de migração no banco de dados de destino.
- DEST_PASSWORD pela senha do usuário de migração no banco de dados de destino.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \ --region=REGION \ --alloydb-cluster=DEST_CLUSTER \ --username=DEST_USER \ --password=DEST_PASSWORD \ --role=DESTINATION \ --no-async
Windows (PowerShell)
gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ` --region=REGION ` --alloydb-cluster=DEST_CLUSTER ` --username=DEST_USER ` --password=DEST_PASSWORD ` --role=DESTINATION ` --no-async
Windows (cmd.exe)
gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^ --region=REGION ^ --alloydb-cluster=DEST_CLUSTER ^ --username=DEST_USER ^ --password=DEST_PASSWORD ^ --role=DESTINATION ^ --no-async
Você receberá uma resposta semelhante a esta:
Waiting for connection profile [DEST_CONN_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created connection profile DEST_CONN_ID [OPERATION_ID]
Crie o job de migração.
O exemplo a seguir representa um cenário de migração em que você usa a conectividade de IP privado entre os bancos de dados de origem e de destino. Se você usar um tipo de conectividade diferente (por exemplo, lista de permissões de IP, peering de VPC ou um túnel SSH reverso), adicione as flags necessárias, como--static-ip,--peer-vpcou--vm,--vm-ip,--vm-porte--vpc. Para mais informações, consulte Configurar conectividade e Exemplos da Google Cloud CLI.
Execute o seguinte comando (clique no link para expandir):gcloud database-migration migration-jobs createEste exemplo usa a flag opcional
--no-asyncpara que todas as operações sejam realizadas de forma síncrona. Isso significa que alguns comandos podem levar um tempo para serem concluídos. É possível pular a flag--no-asyncpara executar comandos de forma assíncrona. Se você fizer isso, use o comandogcloud database-migration operations describepara verificar se a operação foi bem-sucedida.Antes de usar os dados do comando abaixo, faça estas substituições:
- MIGRATION_JOB_ID por um identificador legível por máquina para o job de migração. Use esse valor para trabalhar com jobs de migração usando os comandos da CLI do Google Cloud ou a API do Database Migration Service.
- REGION pelo identificador da região em que você quer salvar o job de migração.
- MIGRATION_JOB_NAME por um nome legível por humanos para o job de migração. Esse valor é exibido no Database Migration Service no console do Google Cloud .
- SOURCE_CONNECTION_PROFILE_ID por um identificador legível por máquina do perfil de conexão de origem. Para mais informações, consulte Criar um perfil de conexão de origem.
- DESTINATION_CONNECTION_PROFILE_ID por um identificador legível por máquina do perfil de conexão de destino.
Opcional: o Database Migration Service migra todos os bancos de dados na origem por padrão. Se você quiser migrar apenas bancos de dados específicos, use a flag
--databases-filtere especifique os identificadores como uma lista separada por vírgulas.Por exemplo:
--databases-filter=my-business-database,my-other-databaseÉ possível editar os jobs de migração criados com a flag
--databases-filterusando o comandogcloud database-migration migration-jobs update.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud database-migration migration-jobs \ create MIGRATION_JOB_ID \ --no-async \ --region=REGION \ --display-name=MIGRATION_JOB_NAME \ --source=SOURCE_CONNECTION_PROFILE_ID \ --destination=DESTINATION_CONNECTION_PROFILE_ID \ --type=CONTINUOUS
Windows (PowerShell)
gcloud database-migration migration-jobs ` create MIGRATION_JOB_ID ` --no-async ` --region=REGION ` --display-name=MIGRATION_JOB_NAME ` --source=SOURCE_CONNECTION_PROFILE_ID ` --destination=DESTINATION_CONNECTION_PROFILE_ID ` --type=CONTINUOUS
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ create MIGRATION_JOB_ID ^ --no-async ^ --region=REGION ^ --display-name=MIGRATION_JOB_NAME ^ --source=SOURCE_CONNECTION_PROFILE_ID ^ --destination=DESTINATION_CONNECTION_PROFILE_ID ^ --type=CONTINUOUS
Você receberá uma resposta semelhante a esta:
Waiting for migration job [MIGRATION_JOB_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created migration job MIGRATION_JOB_ID [OPERATION_ID]
Rebaixe o banco de dados de destino.
O Database Migration Service exige que você rebaixe o cluster de destino atual para configurá-lo como uma réplica externa antes de iniciar o job de migração. Execute o comandogcloud database-migration migration-jobs demote-destination(clique no link para abrir):gcloud database-migration migration-jobs demote-destinationAntes de usar os dados do comando abaixo, faça estas substituições:
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Se você não souber o identificador, use o comando
gcloud database-migration migration-jobs listpara listar todos os jobs de migração em uma determinada região e ver os identificadores deles. - REGION pelo identificador da região em que o job de migração está salvo.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud database-migration migration-jobs \ demote-destination MIGRATION_JOB_ID \ --region=REGION
Windows (PowerShell)
gcloud database-migration migration-jobs ` demote-destination MIGRATION_JOB_ID ` --region=REGION
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ demote-destination MIGRATION_JOB_ID ^ --region=REGION
Resultado
A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração:
done: false metadata: '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata apiVersion: v1 createTime: '2024-02-20T12:20:24.493106418Z' requestedCancellation: false target: MIGRATION_JOB_ID verb: demote-destination name: OPERATION_ID
Para ver se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:
- Use o comando
gcloud database-migration migration-jobs describepara conferir o status do job de migração. - Use o comando
gcloud database-migration operations describecom o OPERATION_ID para ver o status da operação em si.
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Opcional: verifique o job de migração.
Neste ponto, o job de migração está configurado e conectado ao cluster de destino. É possível gerenciá-lo usando as operaçõesverify,start,stop,restarteresume. Recomendamos que você primeiro verifique o job de migração executando o comandogcloud database-migration migration-jobs verify(clique no link para expandir):gcloud database-migration migration-jobs verifyAntes de usar os dados do comando abaixo, faça estas substituições:
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Se você não souber o identificador, use o comando
gcloud database-migration migration-jobs listpara listar todos os jobs de migração em uma determinada região e ver os identificadores deles. - REGION pelo identificador da região em que o job de migração está salvo.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud database-migration migration-jobs \ verify MIGRATION_JOB_ID \ --region=REGION
Windows (PowerShell)
gcloud database-migration migration-jobs ` verify MIGRATION_JOB_ID ` --region=REGION
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ verify MIGRATION_JOB_ID ^ --region=REGION
Resultado
A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração:
done: false metadata: '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata apiVersion: v1 createTime: '2024-02-20T12:20:24.493106418Z' requestedCancellation: false target: MIGRATION_JOB_ID verb: verify name: OPERATION_ID
Para ver se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:
- Use o comando
gcloud database-migration migration-jobs describecom o MIGRATION_JOB_ID para conferir o status do job de migração. - Use o comando
gcloud database-migration operations describecom o OPERATION_ID para ver o status da operação em si.
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Inicie o job de migração.
Inicie o job de migração executando o comandogcloud database-migration migration-jobs start(clique no link para expandir):gcloud database-migration migration-jobs startAntes de usar os dados do comando abaixo, faça estas substituições:
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Se você não souber o identificador, use o comando
gcloud database-migration migration-jobs listpara listar todos os jobs de migração em uma determinada região e ver os identificadores deles. - REGION pelo identificador da região em que o job de migração está salvo.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud database-migration migration-jobs \ start MIGRATION_JOB_ID \ --region=REGION
Windows (PowerShell)
gcloud database-migration migration-jobs ` start MIGRATION_JOB_ID ` --region=REGION
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ start MIGRATION_JOB_ID ^ --region=REGION
Resultado
A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração:
done: false metadata: '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata apiVersion: v1 createTime: '2024-02-20T12:20:24.493106418Z' requestedCancellation: false target: MIGRATION_JOB_ID verb: start name: OPERATION_ID
Para ver se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:
- Use o comando
gcloud database-migration migration-jobs describecom o MIGRATION_JOB_ID para conferir o status do job de migração. - Use o comando
gcloud database-migration operations describecom o OPERATION_ID para ver o status da operação em si.
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Promova o job de migração.
Depois que a migração chegar à fase de captura de dados alterados (CDC), será possível promover o cluster de destino de uma réplica para um cluster principal independente. Execute o comandogcloud database-migration migration-jobs promote(clique no link para expandir):gcloud database-migration migration-jobs promoteAntes de usar os dados do comando abaixo, faça estas substituições:
- MIGRATION_JOB_ID pelo
identificador do job de migração.
Se você não souber o identificador, use o comando
gcloud database-migration migration-jobs listpara listar todos os jobs de migração em uma determinada região e ver os identificadores deles. - REGION pelo identificador da região em que o job de migração está salvo.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud database-migration migration-jobs \ promote MIGRATION_JOB_ID \ --region=REGION
Windows (PowerShell)
gcloud database-migration migration-jobs ` promote MIGRATION_JOB_ID ` --region=REGION
Windows (cmd.exe)
gcloud database-migration migration-jobs ^ promote MIGRATION_JOB_ID ^ --region=REGION
Resultado
A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração:
done: false metadata: '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata apiVersion: v1 createTime: '2024-02-20T12:20:24.493106418Z' requestedCancellation: false target: MIGRATION_JOB_ID verb: promote name: OPERATION_ID
Para ver se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:
- Use o comando
gcloud database-migration migration-jobs describecom o MIGRATION_JOB_ID para conferir o status do job de migração. - Use o comando
gcloud database-migration operations describecom o OPERATION_ID para ver o status da operação em si.
- MIGRATION_JOB_ID pelo
identificador do job de migração.