Data Transmission Service:Sincronizar o ApsaraDB for MongoDB com o PolarDB for MySQL

Pré-requisitos

• Se a sua origem for um cluster fragmentado do ApsaraDB for MongoDB, solicite um endpoint para cada nó de shard e certifique-se de que todos os nós usam a mesma conta e senha. Para mais informações, consulte Apply for a shard endpoint.

• crie um cluster de destino do PolarDB for MySQL com mais espaço de armazenamento do que a instância de origem do ApsaraDB for MongoDB usa. Para mais informações, consulte Custom Purchase e Purchase a subscription cluster.

  Nota

  Recomendamos provisionar 10% a mais de espaço de armazenamento do que o banco de dados de origem usa.

• No cluster de destino do PolarDB for MySQL, crie um banco de dados e uma tabela com uma chave primária. Para mais informações, consulte Database management.

  Importante

  • Certifique-se de que os tipos de dados na tabela de destino são compatíveis com os dados do MongoDB de origem. Por exemplo, se o campo _id do MongoDB for um ObjectId, a coluna correspondente no cluster do PolarDB for MySQL deve ser varchar.

  • Não nomeie as colunas da tabela de destino do PolarDB for MySQL como _id ou _value.

Observações

Faturamento

Tipos de sincronização

Permissões de conta do banco de dados

Procedimento

1. acesse a página da lista de tarefas de sincronização da região de destino. Você pode usar um dos dois métodos a seguir:

   Pelo console do DTS

   1. Faça login no Data Transmission Service (DTS) console.

   2. No painel de navegação à esquerda, clique em Data Synchronization.

   3. No canto superior esquerdo da página, selecione a região onde a instância de sincronização está localizada.

   Pelo console do DMS

   Nota

   As operações reais podem variar com base no modo e no layout do console do DMS. Para mais informações, consulte Simple mode e Customize the layout and style of the DMS interface.

   1. Faça login no Data Management (DMS).

   2. Na barra de menu superior, escolha Data + AI > Data Transmission (DTS) > Data Synchronization.

   3. À direita de Data Synchronization Tasks, selecione a região onde a instância de sincronização está localizada.

2. Clique em Create Task para abrir a página de configuração da tarefa.

3. Configure os bancos de dados de origem e de destino.

   Categoria	Parâmetro	Descrição
   N/D	Task Name	O DTS gera automaticamente um nome para a tarefa. Recomendamos especificar um nome descritivo para facilitar a identificação. O nome não precisa ser exclusivo.
   Source Database	Select Existing Connection	Para usar uma instância de banco de dados added to the system (recém-criada ou salva), selecione a instância de banco de dados na lista suspensa. As informações do banco de dados são configuradas automaticamente. Nota No console do DMS, este item de configuração chama-se Select a DMS database instance.. Se você não adicionou a instância de banco de dados ao sistema ou não precisa usar uma instância já adicionada, configure manualmente as seguintes informações do banco de dados.
   	Database Type	Selecione MongoDB.
   	Access Method	Selecione Alibaba Cloud Instance.
   	Instance Region	Selecione a região da instância de origem do ApsaraDB for MongoDB.
   	Replicate Data Across Alibaba Cloud Accounts	Este exemplo usa uma instância de banco de dados que pertence à conta atual da Alibaba Cloud. Selecione No.
   	Architecture	Neste exemplo, selecione Replica Set. Nota Se a instância de origem do ApsaraDB for MongoDB usar uma arquitetura de Sharded Cluster, você também deve especificar a Shard account e a Shard password.
   	Migration Method	Selecione um método para a sincronização incremental de dados com base nos seus requisitos. Oplog (Recomendado): Esta opção está disponível se o Oplog estiver ativado para o banco de dados de origem. Nota O Oplog é ativado por padrão para bancos de dados MongoDB autogerenciados e instâncias do ApsaraDB for MongoDB. Este método oferece menor latência para tarefas de sincronização incremental porque os logs são recuperados mais rapidamente. Recomendamos selecionar Oplog. ChangeStream: Esta opção está disponível se os Change Streams estiverem ativados para o banco de dados de origem. Nota Se o banco de dados de origem for uma instância do Amazon DocumentDB (cluster não elástico), selecione apenas ChangeStream. Se você definir a Architecture do banco de dados de origem como Sharded Cluster, não é necessário especificar a Shard account e a Shard password.
   	Instance ID	Selecione o ID da instância de origem do ApsaraDB for MongoDB.
   	Authentication Database	Insira o banco de dados de autenticação para a conta na instância de origem do ApsaraDB for MongoDB. O valor padrão é admin.
   	Database Account	Insira a conta do banco de dados da instância de origem do ApsaraDB for MongoDB. Para obter informações sobre as permissões necessárias, consulte database account permissions.
   	Database Password	Insira a senha correspondente à conta do banco de dados.
   	Encryption	O DTS suporta três métodos de conexão: Non-encrypted, SSL-encrypted e Mongo Atlas SSL. As opções de Encryption variam com base no Access Method e na Architecture selecionados. As opções exibidas no console prevalecem. Nota Um banco de dados MongoDB onde a Architecture é Sharded Cluster e o Migration Method é Oplog não suporta SSL-encrypted. Se a origem for um banco de dados MongoDB autogerenciado (o Access Method não é Alibaba Cloud Instance) com arquitetura de Replica Set e você selecionar SSL-encrypted, o DTS também permite o upload de um certificado CA para verificar a conexão.
   Destination Database	Select Existing Connection	Para usar uma instância de banco de dados added to the system (recém-criada ou salva), selecione a instância de banco de dados na lista suspensa. As informações do banco de dados são configuradas automaticamente. Nota No console do DMS, este item de configuração chama-se Select a DMS database instance.. Se você não adicionou a instância de banco de dados ao sistema ou não precisa usar uma instância já adicionada, configure manualmente as seguintes informações do banco de dados.
   	Database Type	Selecione PolarDB for MySQL.
   	Access Method	Selecione Alibaba Cloud Instance.
   	Instance Region	Selecione a região do cluster de destino do PolarDB for MySQL.
   	Replicate Data Across Alibaba Cloud Accounts	Este exemplo usa uma instância de banco de dados que pertence à conta atual da Alibaba Cloud. Selecione No.
   	PolarDB Cluster ID	Selecione o ID do cluster de destino do PolarDB for MySQL.
   	Database Account	Insira a conta do banco de dados do cluster de destino do PolarDB for MySQL. Para obter informações sobre as permissões necessárias, consulte database account permissions.
   	Database Password	Insira a senha correspondente à conta do banco de dados.
   	Encryption	Selecione um método de conexão. Para mais informações sobre criptografia SSL, consulte Configure SSL encryption.

4. Após concluir a configuração, clique em Test Connectivity and Proceed na parte inferior da página.

   Nota

   • Certifique-se de que os blocos CIDR de endereços IP dos servidores do DTS estejam adicionados às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso dos servidores do DTS. Você pode fazer isso automática ou manualmente. Para mais informações, consulte Add the IP address CIDR blocks of DTS servers to a whitelist.

   • Se o banco de dados de origem ou de destino for um banco de dados autogerenciado (onde o Access Method não é Alibaba Cloud Instance), você também deve clicar em Test Connectivity na caixa de diálogo CIDR Blocks of DTS Servers.

5. Configure os objetos da tarefa.

   1. Na página Configure Objects, configure os objetos a serem sincronizados.

      Parâmetro	Descrição
      Synchronization Types	A opção Incremental Data Synchronization está selecionada. Selecione apenas Full Data Synchronization. O DTS não suporta Schema Synchronization. Após a conclusão da pré-verificação, o DTS sincroniza os dados dos objetos selecionados da instância de origem para o cluster de destino. Isso serve como dados de linha de base para a sincronização incremental de dados subsequente.
      Processing Mode of Conflicting Tables	Precheck and Report Errors: Verifica se existe uma tabela com o mesmo nome no banco de dados de destino. Se não existir, a pré-verificação é aprovada. Se existir, a pré-verificação falha e a tarefa de sincronização de dados não é iniciada. Nota Se você não puder excluir ou renomear a tabela com o mesmo nome no banco de dados de destino, mapeie-a para um nome de tabela diferente. Para mais informações, consulte Map table and column names. Ignore Errors and Proceed: Ignora a verificação de nomes de tabelas duplicados no banco de dados de destino. Aviso Selecionar Ignore Errors and Proceed pode causar inconsistência de dados e colocar o seu negócio em risco. Por exemplo: Se os schemas das tabelas forem iguais e um registro no banco de dados de destino tiver o mesmo valor de chave primária ou exclusiva que um registro no banco de dados de origem: Durante a sincronização completa, o DTS mantém o registro no cluster de destino. O registro correspondente do banco de dados de origem não é sincronizado. Durante a sincronização incremental, o registro do banco de dados de origem sobrescreve o registro no banco de dados de destino. Se os schemas das tabelas forem diferentes, a sincronização inicial de dados pode falhar. Isso pode resultar na sincronização de apenas dados parciais de colunas ou em uma falha completa de sincronização. Prossiga com cautela.
      Capitalization of Object Names in Destination Instance	Configure a política de diferenciação de maiúsculas e minúsculas para nomes de objetos de banco de dados, tabelas e colunas sincronizados com a instância de destino. Por padrão, a DTS default policy está selecionada. Você também pode optar por usar as políticas padrão dos bancos de dados de origem e de destino. Para mais informações, consulte Case sensitivity policy for destination object names.
      Source Objects	Na caixa Source Objects, clique em um objeto a ser sincronizado e, em seguida, clique em para movê-lo para a caixa Selected Objects. Nota Selecione objetos para sincronizar no nível da coleção.
      Selected Objects	edite o mapeamento de nomes de banco de dados. Na caixa Selected Objects, clique com o botão direito no banco de dados que contém a coleção a ser sincronizada. Altere o Schema Name para o nome do banco de dados no cluster de destino do PolarDB for MySQL que receberá os dados. Clique em OK. edite o mapeamento de nomes de tabelas. Na caixa Selected Objects, clique com o botão direito na coleção a ser sincronizada. Altere o Table Name para o nome da tabela no cluster de destino do PolarDB for MySQL que receberá os dados. Opcional: Defina condições de filtro para a sincronização completa de dados. Para mais informações, consulte Set filter conditions. A sintaxe para condições de filtro difere das cláusulas WHERE padrão do SQL e deve usar a sintaxe de consulta do MongoDB. Por exemplo, para filtrar por ID de usuário, insira {"_id": {$gt:"user100844658590795**",$lte:"user101674868045948**"}}, onde $gt significa "maior que" e $lte significa "menor ou igual a". Opcional: Na seção Select DDL and DML Operations to Be Synchronized, selecione as operações a serem sincronizadas incrementalmente. As operações DDL disponíveis incluem CREATE INDEX e DROP INDEX. As operações DML disponíveis incluem insert, update e delete. Clique em Select All para selecionar todas as operações de uma vez. Configure os campos do MongoDB a serem sincronizados. Por padrão, o DTS mapeia os dados da coleção e configura uma expressão na coluna Parameter Value. verifique se a expressão atende aos seus requisitos e especifique os parâmetros Column Name, Type, Length e Precision. Importante Atribua o valor bson_value("_id") à coluna de chave primária da tabela de destino. Ao configurar uma expressão bson_value(), especifique o caminho até o subcampo de nível mais baixo na hierarquia. Caso contrário, pode ocorrer perda de dados ou falha na tarefa. Na coluna Parameter Value, visualize o nome do campo do MongoDB para a linha atual na expressão bson_value(). O nome do campo é especificado entre aspas duplas (""). Por exemplo, se a expressão for bson_value("age"), a linha corresponde ao campo age no MongoDB. Opcional: exclua os campos que você não precisa sincronizar. Nota Para excluir um campo que você não precisa sincronizar, clique no ícone na linha correspondente. Configure os campos a serem sincronizados. Prossiga de acordo com a adequação da expressão bson_value() aos seus requisitos. Default expression Insira um Column Name. Nota Este é o nome da coluna na tabela que recebe dados no cluster de destino do PolarDB for MySQL. Selecione um Type de dados para a coluna. Importante Certifique-se de que o tipo de dados da tabela de destino seja compatível com os dados no banco de dados MongoDB de origem. Para mais informações sobre mapeamentos de tipos de dados, consulte Data type mapping. Opcional: Configure o Length e a Precision para os dados da coluna. Repita as etapas anteriores para mapear todos os campos relevantes. Custom expression Nota Isso inclui campos com relacionamentos hierárquicos, como estruturas pai-filho. Na coluna Actions, clique no ícone na linha correspondente. Clique em + Add Column. Configure o Column Name, o Type, o Length e a Precision. Na caixa de texto sob Parameter Value, insira uma expressão bson_value(). Para mais informações, consulte Value assignment examples. Repita as etapas anteriores para mapear todos os campos relevantes. Clique em OK.

   2. Clique em Next: Advanced Settings para configurar parâmetros avançados.

      Parâmetro	Descrição
      Dedicated Cluster for Task Scheduling	Por padrão, o DTS agenda tarefas em um cluster compartilhado, e você não precisa selecionar um cluster. Para um desempenho mais estável, adquira um cluster dedicado para executar tarefas de sincronização do DTS. Para mais informações, consulte What is a DTS dedicated cluster?.
      Select the engine type of the destination database	Selecione um tipo de mecanismo para o banco de dados de destino. InnoDB: O mecanismo de armazenamento padrão. X-Engine: Um mecanismo de armazenamento de banco de dados para processamento de transações online (OLTP).
      Retry Time for Failed Connections	Após o início de uma tarefa de sincronização, se a conexão com o banco de dados de origem ou de destino falhar, o DTS relata um erro e começa imediatamente a tentar reconectar. A duração padrão de nova tentativa é de 720 minutos. Especifique uma duração personalizada de nova tentativa de 10 a 1.440 minutos. Recomendamos definir a duração para 30 minutos ou mais. Se o DTS reconectar com sucesso ao banco de dados dentro da duração especificada, a tarefa de sincronização será retomada automaticamente. Caso contrário, a tarefa falhará. Nota Se você tiver várias instâncias do DTS (por exemplo, Instância A e Instância B) que compartilham a mesma origem ou destino, e definir o tempo de nova tentativa de rede para 30 minutos na Instância A e 60 minutos na Instância B, a duração menor de 30 minutos será usada para ambas. Como o DTS cobra pelo tempo de execução da tarefa durante o período de nova tentativa de conexão, recomendamos personalizar a duração da nova tentativa com base nas necessidades do seu negócio ou liberar a instância do DTS o mais rápido possível após a liberação das instâncias de banco de dados de origem e de destino.
      Retry Time for Other Issues	Após o início da tarefa de sincronização, se ocorrerem outros problemas não relacionados à conectividade com o banco de dados de origem ou de destino (como exceções de execução de DDL ou DML), o DTS relata um erro e inicia imediatamente operações contínuas de nova tentativa. A duração padrão de nova tentativa é de 10 minutos. Personalize a duração da nova tentativa dentro do intervalo de 1 a 1.440 minutos. Recomendamos definir para 10 minutos ou mais. Se as operações relevantes forem bem-sucedidas dentro da duração de nova tentativa definida, a tarefa de sincronização será retomada automaticamente. Caso contrário, a tarefa falhará. Importante O valor para Retry Time for Other Issues deve ser menor que o valor para Retry Time for Failed Connections.
      Enable Throttling for Full Data Synchronization	Durante a etapa de sincronização completa, o DTS consome recursos de leitura e gravação dos bancos de dados de origem e de destino, o que pode aumentar a carga do banco de dados. Para reduzir a carga nos bancos de dados de origem e de destino, defina um limite de taxa para a tarefa de sincronização completa configurando os parâmetros Queries per second (QPS) to the source database, RPS of Full Data Migration e Data migration speed for full migration (MB/s). Nota Este item de configuração está disponível apenas quando Synchronization Types está definido como Full Data Synchronization. Você também pode adjust the full synchronization rate após a instância de sincronização entrar em execução.
      Only one data type for primary key _id in a table of the data to be synchronized	Especifica se a chave primária _id usa um único tipo de dados consistente dentro de cada coleção a ser sincronizada. Importante Selecione uma opção com base nos seus dados reais. Uma seleção incorreta pode levar à perda de dados. Este parâmetro está disponível apenas se Synchronization Types incluir Full Data Synchronization. Yes: Os tipos de dados são exclusivos. Durante a fase de sincronização completa, o DTS não verifica os tipos de dados das chaves primárias nos dados de origem. Para cada coleção, o DTS sincroniza apenas os dados correspondentes a um tipo de dados de chave primária. No: Os tipos de dados não são exclusivos. Durante a fase de sincronização completa, o DTS verifica os tipos de dados das chaves primárias nos dados de origem e sincroniza todos os dados.
      Enable Throttling for Incremental Data Synchronization	Defina um limite de taxa para a tarefa de sincronização incremental. Para aliviar a pressão no banco de dados de destino, defina o RPS of Incremental Data Synchronization e a Data synchronization speed for incremental synchronization (MB/s).
      Environment Tag	Selecione uma tag de ambiente para identificar a instância. Nenhuma tag é necessária neste exemplo.
      Configure ETL	Escolha se deseja ativar o recurso de extração, transformação e carga (ETL). Para mais informações, consulte What is ETL? Valores válidos: Yes: Ativa o recurso ETL. Insira instruções de processamento de dados no editor de código. Para mais informações, consulte Configure ETL in a data migration or data synchronization task. No: Desativa o recurso ETL.
      Monitoring and Alerting	Especifique se deseja configurar alertas. Se a sincronização falhar ou a latência exceder o limiar especificado, uma notificação será enviada para um contato de alerta. No: Nenhum alerta é configurado. Yes: Configure alertas definindo um limiar de alerta e especificando um notificação de alerta. Para mais informações, consulte Configure monitoring and alerting during task configuration.

6. salve a tarefa e execute uma pré-verificação.

   • Para visualizar os parâmetros da API para configurar esta instância, passe o mouse sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters na dica.

   • Após visualizar os parâmetros da API, clique em Next: Save Task Settings and Precheck na parte inferior da página.

   Nota

   • Antes do início da tarefa de sincronização, o DTS executa uma pré-verificação. A tarefa só pode ser iniciada após a aprovação de todos os itens de pré-verificação.

   • Se a pré-verificação falhar, clique em View Details para o item com falha. Corrija o problema conforme instruído e, em seguida, execute a pré-verificação novamente.

   • Se a pré-verificação retornar um aviso:

     • Se um item de verificação falhar e não puder ser ignorado, clique em View Details ao lado do item. Siga as instruções para corrigir o problema e, em seguida, execute a pré-verificação novamente.

     • Para itens de verificação que podem ser ignorados, clique em Confirm Alert Details, Ignore, OK e Precheck Again em sequência para pular o aviso e executar a pré-verificação novamente. Se você optar por ocultar o item de aviso, isso pode causar problemas como inconsistência de dados e representar riscos para o seu negócio.

7. Adquira a instância.

   1. Quando a Success Rate for de 100%, clique em Next: Purchase Instance.

   2. Na página Purchase, selecione o método de faturamento e a especificação de link para a instância de sincronização de dados. A tabela a seguir descreve esses parâmetros em detalhes.

      Categoria	Parâmetro	Descrição
      New Instance Class	Billing Method	Assinatura: Você paga ao criar a instância. Isso é adequado para necessidades de longo prazo e é mais econômico do que o pagamento conforme o uso. Quanto maior a duração da assinatura, maior o desconto. Pagamento conforme o uso: a cobrança é por hora. Isso é adequado para necessidades de curto prazo. Libere a instância imediatamente após o uso para economizar custos.
      	Resource Group Configuration	O grupo de recursos ao qual a instância pertence. O padrão é o grupo de recursos padrão. Para mais informações, consulte What is Resource Management?.
      	Link Specification	O DTS fornece especificações de sincronização com diferentes níveis de desempenho. A especificação do link de sincronização afeta a taxa de sincronização. Escolha uma especificação com base no seu cenário de negócios. Para mais informações, consulte Data synchronization link specifications.
      	Subscription Duration	No modo de assinatura, selecione a duração e a quantidade para a instância de assinatura. Você pode escolher uma assinatura mensal de 1 a 9 meses, ou uma assinatura anual de 1, 2, 3 ou 5 anos. Nota Esta opção está disponível apenas quando o método de faturamento é Subscription.

   3. Após concluir a configuração, leia e selecione Data Transmission Service (Pay-as-you-go) Service Terms.

   4. Clique em Buy and Start. Na caixa de diálogo OK, clique em OK.

      Você pode visualizar o progresso da tarefa na página Data Synchronization.

Mapeamento de tipos de dados

Exemplo de configuração de atribuição

{
  "_id":"62cd344c85c1ea6a2a9f****",
  "person":{
    "name":"neo",
    "age":26,
    "sex":"male"
  }
}