Criar uma tarefa de migração
As tarefas de migração são os processos de trabalho responsáveis por transferir seus dados e esquemas de um banco de dados relacional para o MongoDB. Crie um novo tarefa de migração na aba Data Migration.
Esta tarefa também se aplica a tarefas de migração contínua suportadas pelo Apache Kafka. Não há diferença de procedimento introduzida ao usar o Kafka. Para obter mais detalhes,consulte Integração do Relational Migrator com o Kafka.
Sobre esta tarefa
As credenciais de URI fornecidas ao criar um tarefa de migração não precisam ser iguais às credenciais usadas ao criar seu projeto.
Use uma Conexão de Banco de Dados Relacional existente ou crie uma ao criar o tarefa de migração.
As tarefas de migração contínua usando o Confluent Cloud Kafka podem levar mais tempo devido ao provisionamento de recursos de backend no Confluent Cloud. Esse processo normalmente leva de dois a cinco minutos adicionais na primeira vez que um tarefa de migração de CDC é executado.
Você pode recuperar uma tarefa de migração contínua dentro de 24 horas após a falha. Para obter detalhes, consulte Recuperar um trabalho de migração.
Antes de começar
Crie uma ou mais regras de mapeamento em seu projeto do Relational Migrator.
Para sistemas Atlas e on-premises, crie um usuário MongoDB separado para o Relational Migrator com
readWrite
acesso ao seu banco de dados MongoDB .
Passos
Insira os detalhes da conexão do banco de dados relacional
No formulário Connect to your source database , insira os detalhes da conexão para criar o URI JDBC para seu relational database.
Para usar uma conexão de banco de dados relacional salva, clique Use a saved connection em e selecione-a no menu suspenso e, em seguida, insira as credenciais, se necessário.
Para criar uma nova conexão:
Na lista suspensa Database type, selecione o tipo de banco de dados .
Para inserir uma string de conexão diretamente, ative o Enter URI manually botão e cole sua string de conexão JDBC URI no.
Para criar uma string de conexão inserindo informações do banco de dados , digite o seguinte:
CampoValorHost
O nome IP ou DNS do host.
Port
O número da porta.
Database
O nome do banco de dados . Obrigatório.
Identifier
Um de Service Name ou SID.
Username e a Password
As credenciais a serem usadas para autenticação.
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
CampoValorHost
O nome IP ou DNS do host.
Port
O número da porta.
Database
O nome do banco de dados . Se estiver em branco, você só verá objetos no esquema
dbo
padrão em todos os bancos de dados.Authentication
Por padrão, isso é definido como SQL Server. Defina Windows como para ativar a Autenticação Integrada do Windows, usando as credenciais do usuário que iniciou o executável Relational Migrator . Isto desabilita os campos Username e Password.
Username e a Password
As credenciais a serem usadas para autenticação. Desativado se Authentication estiver definido como Windows.
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
General / SSL Alternar
Visualizar as configurações SSL para a conexão.
Para usar SSL, você deve primeiro descomentar e atualizar as
server.ssl
propriedades de configuração do em seuuser.properties
arquivo.SSL: Use SSL
Habilite ou desabilite o SSL.
SSL: Trust server certificate
Com o SSL ativado, verifique para confiar no certificado armazenado. Deixe desmarcado para verificar o certificado do servidor em relação a uma Autoridade de certificação confiável.
CampoValorHost
O nome IP ou DNS do host.
Port
O número da porta.
Database
O nome do banco de dados . Deixe em branco para carregar todos os bancos de dados.
Username e a Password
As credenciais a serem usadas para autenticação.
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
General / SSL Alternar
Visualizar as configurações SSL para a conexão.
Para usar SSL, você deve primeiro descomentar e atualizar as
server.ssl
propriedades de configuração do em seuuser.properties
arquivo.SSL: Use SSL
Habilite ou desabilite o SSL.
SSL: SSL mode
Com o SSL ativado, escolha entre:
Preferred (padrão): faça uma conexão criptografada, se possível, caso contrário, retorne para uma conexão não criptografada.
Required: Exigem uma conexão criptografada.
Verify CA: Verifique o certificado do servidor em relação a uma Autoridade de Certificação confiável.
Verify identity: Verifique as informações de conexão do banco de dados em relação ao conteúdo do certificado.
CampoValorHost
O nome IP ou DNS do host.
Port
O número da porta.
Database
O nome do banco de dados . Deixe em branco para se conectar ao banco de dados padrão .
Username e a Password
As credenciais a serem usadas para autenticação.
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
General / SSL Alternar
Visualizar as configurações SSL para a conexão.
Para usar SSL, você deve primeiro descomentar e atualizar as
server.ssl
propriedades de configuração do em seuuser.properties
arquivo.SSL: Use SSL
Habilite ou desabilite o SSL.
SSL: SSL mode
Com o SSL ativado, escolha entre:
Prefer (padrão): faça uma conexão criptografada, se possível, caso contrário, retorne para uma conexão não criptografada.
Require: Exigem uma conexão criptografada.
Verify CA: Verifique o certificado do servidor em relação a uma Autoridade de Certificação confiável.
Verify full: Verifique as informações de conexão do banco de dados em relação ao conteúdo do certificado.
CampoValorHost
O nome IP ou DNS do host.
Port
O número da porta.
Database
O nome do banco de dados . Obrigatório.
Username e a Password
As credenciais a serem usadas para autenticação.
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
CampoValorHost
O nome IP ou DNS do host.
Port
O número da porta.
Database
O nome do banco de dados . Deixe em branco para se conectar ao banco de dados padrão .
Username e a Password
As credenciais a serem usadas para autenticação.
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
Insira um Connection name e Environment tagopcional.
Clique em Connect.
A conexão salva está disponível para uso em todas as tarefas e projetos.
Insira os detalhes da conexão do MongoDB
Para usar uma conexão MongoDB salva, clique Use a saved connection em e selecione-a no menu suspenso e insira as credenciais, se necessário.
Para criar uma nova conexão:
Insira a string de conexão do MongoDB .
MongoDB connection string (URI)No,insira seu URI MongoDB .
Se você estiver usando a 509 autenticação X., o Relational Migrator verificará a sintaxe da string de conexão e o formato do arquivo do certificado.
Se não estiver incluído na string de conexão, insira o Database para se conectar.
Se eles não estiverem incluídos na string de conexão e você não estiver usando a509 autenticação X., insira o Username e o Password do seu usuário Relational Migrator MongoDB .
Insira um Connection name e Environment tagopcional.
Clique em Connect.
A conexão salva está disponível para uso em todas as tarefas e projetos.
No Migration Options formulário,Migration Options selecione:
Opção de migração | Descrição |
---|---|
Modo | Define o tipo de tarefa de migração. |
Solte as collection de destino antes da migração | Boolean. Indica se o Relational Migrator descarta uma collection de destino antes de transferir dados. |
Parar após erros | Inteiro. Indica o número de erros após os quais o Relational Migrator interrompe a tarefa de migração . |
Verificar dados migrados | Boolean. Se true, o mecanismo de sincronização verifica os dados migrados em relação ao banco de dados de origem. Compatível apenas com o modo snapshot . |
Ao definir o Mode, o Relational Migrator verifica se o banco de dados está configurado corretamente. Se encontrar problemas, exibirá um banner de aviso e um botão Generate Script para baixar um script SQL. Este script inclui as declarações de configuração necessárias e quaisquer instruções adicionais como comentários.
Aviso
Antes de iniciar um tarefa de migração :
Baixe o roteiro.
Revise cuidadosamente seu conteúdo.
Execute as declarações.
Siga quaisquer etapas manuais comentadas.
Revise e inicie seu tarefa de migração
No formulário Review Summary, você pode ver detalhes sobre seu tarefa de migração. Esses detalhes incluem o tipo, o número de tabelas e linhas afetadas e o tamanho estimado dos dados da tarefa de migração. Para iniciar seu tarefa de migração, clique em Start.
Para visualizar os detalhes de implantação das tarefas de migração do Kafka, selecione a tarefa no painel History na tela Data Migration e passe o mouse sobre o ícone ao lado do botão Create Migration Job.
Importante
Para grandes trabalhos de migração para um Atlas cluster, o resumo da revisão pode incluir Atlas Performance Suggestions que recomendam camadas de cluster mais altas. A atualização é opcional, mas reduz o tempo de migração.
Clique em Upgrade on Atlas para abrir o Atlas em uma nova guia ou janela do navegador. Se você deseja atualizar, mas não tem as permissões necessárias, entre em contato com seu administrador.
Próximos passos
Saiba mais
Para obter informações detalhadas sobre os requisitos de configuração de cada banco de dados de dados, consulte o seguinte: