Data Transmission Service:Sincronizar PolarDB for MySQL com o Kafka

Pré-requisitos

• Crie uma instância de destino do ApsaraMQ for Kafka. Para mais informações, consulte Overview.

  Nota

  Para obter informações sobre as versões compatíveis na origem e no destino, consulte Overview of data synchronization solutions.

• Crie um tópico na instância de destino do ApsaraMQ for Kafka para receber os dados sincronizados. Para mais informações, consulte Step 1: Create a topic.

Limitações

Limite de tamanho de registro único

O tamanho de um único registro gravado no Kafka é limitado a 10 MB. Se uma única linha no banco de dados de origem exceder 10 MB, o DTS não conseguirá gravá-la no Kafka e a tarefa será interrompida. Nesse caso, recomendamos que você não sincronize a tabela afetada. Se for obrigatório sincronizar a tabela, sincronize apenas algumas colunas. Ao configurar a tarefa do DTS, filtre os registros com campos grandes. Se a tarefa já estiver em execução, modifique os objetos de sincronização para remover a tabela e, em seguida, adicione-a novamente filtrando as colunas de campo grande para ignorá-las na sincronização.

Topologias de sincronização suportadas

• Sincronização unidirecional um para um.

• Sincronização unidirecional um para muitos.

• Sincronização unidirecional muitos para um.

• Sincronização unidirecional em cascata.

Para mais detalhes e notas importantes de uso, consulte Introduction to data synchronization topologies.

Operações SQL suportadas

Permissões da conta do banco de dados

Procedimento

1. Acesse a página da lista de tarefas de sincronização da região de destino. Use um dos dois métodos a seguir:

   Pelo console do DTS

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

   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 dependendo do modo e do 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 acessar a página de configuração da tarefa.

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

   Aviso

   Após selecionar as instâncias de origem e de destino, leia atentamente as limitações exibidas na parte superior da página. Se você não seguir as limitações, a tarefa poderá falhar ou poderá ocorrer inconsistência de dados.

   Categoria	Parâmetro	Descrição
   N/A	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 que seja 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 serã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.
   	Connection Type	Selecione Alibaba Cloud Instance.
   	Instance Region	Selecione a região onde reside o cluster PolarDB for MySQL de origem.
   	Cross-account	Neste cenário, os dados são sincronizados dentro da mesma conta Alibaba Cloud. Selecione No.
   	PolarDB Cluster ID	Selecione o ID do cluster PolarDB for MySQL de origem.
   	Database Account	Insira a conta do banco de dados do cluster PolarDB for MySQL de origem. Para ver as permissões necessárias, consulte Permissions required for the database account.
   	Database Password	Insira a senha correspondente à conta do banco de dados.
   	Connection Method	Selecione Non-encrypted ou SSL-encrypted conforme necessário. Se você selecionar SSL-encrypted, deverá ativar a criptografia SSL para a instância RDS for MySQL antecipadamente. Para mais informações, consulte Use a cloud certificate to quickly enable SSL encryption.
   	Encryption	Selecione uma opção com base nos seus requisitos. Para mais informações, consulte Configure SSL encryption.
   Destination Database	Select Existing Connection	Para usar uma instância de banco de dados que seja 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 serã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 Kafka.
   	Connection Type	Selecione Express Connect, VPN Gateway, or Smart Access Gateway. Nota Nesta etapa, a instância do Message Queue for Apache Kafka é configurada como um banco de dados Kafka autogerenciado.
   	Instance Region	Selecione a região onde reside a instância de destino do Message Queue for Apache Kafka.
   	Connected VPC	Selecione o ID da Virtual Private Cloud (VPC) à qual pertence a instância de destino do Message Queue for Apache Kafka. Você pode encontrar o ID da VPC na página Basic Information da instância Kafka.
   	Hostname or IP address	Insira um endereço IP do Default Endpoint da instância do Message Queue for Apache Kafka. Nota Você pode obter o endereço IP do Default Endpoint na página Basic Information da instância do Message Queue for Apache Kafka.
   	Port Number	A porta de service da instância do Message Queue for Apache Kafka. O valor padrão é 9092.
   	Database Account	Insira a conta do banco de dados para a instância de destino do Message Queue for Apache Kafka. Nota Se o tipo de instância do Message Queue for Apache Kafka for VPC instance, não será necessário configurar Database Account e Database Password.
   	Database Password	Insira a senha correspondente à conta do banco de dados.
   	Kafka Version	Selecione a versão correspondente à sua instância Kafka.
   	Connection Method	Selecione Non-encrypted ou SCRAM-SHA-256 com base nos seus requisitos de negócios e segurança.
   	Topic	Na lista suspensa, selecione o tópico para receber os dados sincronizados.
   	Use Kafka Schema Registry	O Kafka Schema Registry é uma camada de service de metadados com uma API RESTful para armazenar e recuperar esquemas Avro. No: Não usar o Kafka Schema Registry. Yes: Usar o Kafka Schema Registry. É necessário inserir a URL ou o endereço IP registrado para o esquema Avro no Kafka Schema Registry.

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 foram adicionados às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso dos servidores do DTS. Isso pode ser feito 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), também será necessário 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	Incremental Data Synchronization está selecionado. Por padrão, você também deve selecionar Schema Synchronization e Full Data Synchronization. Após a conclusão da pré-verificação, o DTS realiza uma sincronização completa de dados dos objetos selecionados da instância de origem para o cluster de destino. Isso serve como dados de base para a subsequente sincronização incremental de dados. Nota Se o Access Method para a instância Kafka de destino for Alibaba Cloud Instance, a Schema Synchronization não será suportada.
      Processing Mode for Existing Tables in Destination	Precheck and Report Errors: Verifica se existe uma tabela com o mesmo nome no banco de dados de destino. Se não existir uma tabela com o mesmo nome, a pré-verificação é aprovada. Se existir uma tabela com o mesmo nome, a pré-verificação falhará e a tarefa de sincronização de dados não será iniciada. Nota Se não for possível excluir ou renomear a tabela com o mesmo nome no banco de dados de destino, você poderá mapeá-la 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 seus negócios em risco. Por exemplo: Se os esquemas das tabelas forem iguais e um registro no banco de dados de destino tiver o mesmo valor de chave primária ou chave única 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 substitui o registro no banco de dados de destino. Se os esquemas das tabelas forem diferentes, a sincronização inicial de dados poderá falhar. Isso pode resultar na sincronização de apenas dados parciais de colunas ou em uma falha completa de sincronização. Prossiga com cautela.
      Data Format in Kafka	Selecione o formato de armazenamento de dados para a instância Kafka com base nos seus requisitos. Se você selecionar DTS Avro, deverá analisar os dados com base na definição de esquema DTS Avro. Para mais informações, consulte Definição de esquema DTS Avro e Exemplo de desserialização DTS Avro. Se você selecionar Canal JSON, consulte Canal JSON format para descrições de parâmetros e exemplos. Se você selecionar Shareplex JSON, consulte Shareplex JSON format para descrições de parâmetros e exemplos.
      Kafka Data Compression Format	Selecione o formato de compressão para mensagens do Kafka com base nos requisitos do seu negócio. LZ4 (padrão): A taxa de compressão é baixa, mas a velocidade de compressão é alta. GZIP: A taxa de compressão é alta, mas a velocidade de compressão é baixa. Nota O consumo de CPU é alto. Snappy: A taxa de compressão e a velocidade de compressão são médias.
      Policy for Shipping Data to Kafka Partitions	Selecione uma policy com base nos requisitos do seu negócio.
      Message acknowledgement mechanism	Selecione um message acknowledgment mechanism com base nos requisitos do seu negócio.
      Topic That Stores DDL Information	Selecione na lista suspensa o tópico usado para armazenar informações DDL. Nota Se não for especificado, as informações DDL serão armazenadas por padrão no tópico que recebe os dados.
      Case Sensitivity Policy for Destination Object Names	É possível configurar 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 para sincronizar e, em seguida, clique em para movê-lo para a caixa Selected Objects. Nota Você só pode selecionar objetos para sincronizar no nível da tabela.
      Selected Objects	Nenhuma configuração adicional é necessária neste exemplo. Você pode usar o recurso de mapeamento para definir o nome do tópico, o número de partições e a chave de partição da tabela de origem na instância Kafka de destino. Para mais informações, consulte Mapping information. Nota Para selecionar as operações SQL a serem sincronizadas no nível do esquema ou da tabela, clique com o botão direito em um objeto no painel Selected Objects e selecione as operações SQL desejadas na caixa de diálogo exibida. Se você usar o mapeamento de nomes de objetos, a sincronização de objetos dependentes poderá falhar.

   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 não é necessário selecionar um cluster. Para obter um desempenho mais estável, você pode adquirir um cluster dedicado para executar tarefas de sincronização do DTS. Para mais informações, consulte What is a DTS dedicated cluster?.
      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 reportará um erro e iniciará imediatamente uma nova tentativa de conexão. A duração padrão de nova tentativa é de 720 minutos. Você também pode especificar 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 DDL ou DML), o DTS reportará um erro e iniciará imediatamente operações contínuas de nova tentativa. A duração padrão de nova tentativa é de 10 minutos. Você também pode personalizar 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 fase 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, você pode definir 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 depois que a instância de sincronização estiver em execução.
      Enable Throttling for Incremental Data Synchronization	Você também pode definir um limite de taxa para a tarefa de sincronização incremental. Para aliviar a pressão no banco de dados de destino, defina RPS of Incremental Data Synchronization e Data synchronization speed for incremental synchronization (MB/s).
      Whether to delete SQL operations on heartbeat tables of forward and reverse tasks	Escolha se deseja gravar informações SQL de heartbeat no banco de dados de origem enquanto a instância do DTS está em execução. Yes: As informações SQL de heartbeat não são gravadas no banco de dados de origem. Isso pode fazer com que a instância do DTS reporte um atraso. No: Grava informações SQL de heartbeat no banco de dados de origem. Isso pode interferir em recursos como backup físico e clonagem do banco de dados de origem.
      Environment Tag	Você pode selecionar uma tag de ambiente para identificar a instância. Nenhuma seleção é necessária para este exemplo.
      Configure ETL	Escolha se deseja ativar o recurso de extração, transformação e carregamento (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 a 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 no balão.

   • Se você terminou de 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 do trabalho de sincronização, o DTS executa uma pré-verificação. O trabalho só pode começar após todos os itens de pré-verificação serem aprovados.

   • Se a pré-verificação falhar, clique em View Details para o item com falha. Corrija o problema conforme instruído e 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 execute a pré-verificação novamente.

     • Para itens de verificação que podem ser ignorados, você pode clicar 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 ignorar o item de aviso, isso poderá causar problemas como inconsistência de dados e representar riscos aos seus negócios.

7. Adquira uma 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	Método de Faturamento	Assinatura: Você paga ao criar a instância. Adequado para necessidades de longo prazo e mais econômico que o pagamento conforme o uso. Quanto maior a duração da assinatura, maior o desconto. Pagamento conforme o uso: A cobrança é feita por hora. Adequado para necessidades de curto prazo. Você pode liberar a instância imediatamente após o uso para economizar custos.
      	Configuração do Grupo de Recursos	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?.
      	Especificação do Link	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. Você pode escolher uma especificação com base no seu cenário de negócios. Para mais informações, consulte Data synchronization link specifications.
      	Duração da Assinatura	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.

Informações de mapeamento

1. Na área Selected Objects, passe o mouse sobre o nome do tópico de destino (no nível da tabela).

2. Clique em Edit que aparece ao lado do nome do tópico de destino.

3. Na caixa de diálogo Edit Table exibida, configure as informações de mapeamento.

   Nota

   • No nível do banco de dados, a caixa de diálogo Edit Schema oferece suporte a menos parâmetros configuráveis. No nível da tabela, a caixa de diálogo Edit Table é exibida.

   • Se a granularidade dos objetos de sincronização não for o banco de dados inteiro, você não poderá modificar o Name of target Topic ou o Number of Partitions na caixa de diálogo Edit Schema.

   Parâmetro	Descrição
   Name of target Topic	O nome do tópico de destino para o qual a tabela de origem é sincronizada. O valor padrão é o Topic que você especificou para o Destination Database na etapa Configurations for Source and Destination Databases. Importante Quando o banco de dados de destino é uma instância ApsaraMQ for Kafka, o nome do tópico especificado deve existir na instância Kafka de destino. Caso contrário, a sincronização de dados falhará. Se o banco de dados de destino for um banco de dados Kafka autogerenciado e a tarefa de sincronização incluir sincronização de esquema, o DTS tentará criar o tópico especificado no banco de dados de destino. Se você modificar o Name of target Topic, os dados serão gravados no tópico especificado.
   Filter Conditions	Para mais informações, consulte Filter task data with an SQL condition.
   Number of Partitions	O número de partições quando os dados são gravados no tópico de destino.
   Partition Key	Quando a Policy for Shipping Data to Kafka Partitions está definida como Ship Data to Separate Partitions Based on Hash Values of Primary Keys, você pode configurar este parâmetro. Especifique uma ou mais colunas como Partition Key usada para calcular o valor de hash. O DTS então entrega linhas em diferentes partições do tópico de destino com base nos valores de hash calculados. Nota Você só pode selecionar Partition Key na caixa de diálogo Edit Table.

4. Clique em OK.

Perguntas frequentes

• Posso modificar o Kafka Data Compression Format?

  Sim. Você pode usar o recurso Modify synchronization objects para modificá-lo.

• Posso modificar o Message acknowledgement mechanism?

  Sim. Você pode usar o recurso Modify synchronization objects para modificá-lo.