Synchronize PolarDB-X 1.0 to Message Queue for Kafka - Data Transmission Service: Central de Documentação do Alibaba Cloud

Este tópico explica como sincronizar dados de uma instância PolarDB-X 1.0 para uma instância Alibaba Cloud Message Queue for Apache Kafka usando o Data Transmission Service (DTS).

Pré-requisitos

Crie uma instância ApsaraMQ for Kafka e um tópico para receber os dados sincronizados. Para mais informações, consulte {{XREF_2}}.

Nota
Para verificar as versões compatíveis entre origem e destino, consulte {{XREF_3}}.
O espaço de armazenamento da instância ApsaraMQ for Kafka de destino deve ser superior ao espaço utilizado pela instância PolarDB-X 1.0 de origem.

Limitações

Tipo	Descrição
Limitações do banco de dados de origem	As tabelas a serem sincronizadas devem ter uma chave primária ou uma restrição única para garantir que cada linha seja exclusiva e evitar dados duplicados no banco de dados de destino. Se uma tabela tiver apenas uma restrição única, a sincronização de schema não será suportada para essa tabela. Recomendamos o uso de uma chave primária. A sincronização de tabelas com índices secundários não é suportada. Ao sincronizar dados no nível de tabela e executar operações de edição, como mapeamento de nomes de colunas, uma única tarefa de sincronização suporta no máximo 5.000 tabelas. Caso ultrapasse esse limite, divida as tabelas em várias tarefas ou sincronize todo o banco de dados. Caso contrário, pode ocorrer um erro de solicitação ao enviar a tarefa. Os binary logs das instâncias ApsaraDB RDS for MySQL anexadas à instância PolarDB-X 1.0 de origem devem atender aos seguintes requisitos: O recurso de binary logging deve estar ativado e o parâmetro `binlog_row_image` deve estar definido como `full`. Caso contrário, a pré-verificação falhará e a tarefa de sincronização de dados não poderá ser iniciada. Para uma tarefa de sincronização incremental de dados, mantenha os binary logs do banco de dados de origem por pelo menos 24 horas. Para uma tarefa que inclui sincronização completa e incremental, os binary logs devem ser retidos por pelo menos 7 dias. É possível reduzir o período de retenção para 24 horas após a conclusão da sincronização completa dos dados. Se o DTS não conseguir obter os binary logs devido a um período de retenção muito curto, a tarefa poderá falhar. Em casos extremos, pode ocorrer inconsistência ou perda de dados. Problemas causados por um período de retenção de binary logs inferior ao exigido pelo DTS não são cobertos pelo Acordo de Nível de Serviço (SLA) do DTS. Limitações nas operações do banco de dados de origem: Se você alterar o tipo de rede da instância PolarDB-X 1.0 durante a sincronização de dados, atualize as informações de conexão do link de sincronização. Durante a sincronização de dados, não realize dimensionamento na instância de origem, como escalar suas instâncias ApsaraDB RDS for MySQL anexadas. Não altere a distribuição de tabelas físicas correspondentes às tabelas lógicas nas instâncias ApsaraDB RDS for MySQL, nem modifique chaves de shard ou execute operações DDL. Caso contrário, a tarefa de sincronização de dados poderá falhar ou ocorrer inconsistência de dados. Se realizar apenas a sincronização completa, não grave novos dados na instância de origem. Caso contrário, haverá inconsistência de dados entre os bancos de origem e destino. Para manter a consistência dos dados em tempo real, recomendamos selecionar a sincronização de schema, a sincronização completa e a sincronização incremental. Não execute operações DDL que alterem schemas de bancos de dados ou tabelas durante a sincronização de schema ou a sincronização completa. Caso contrário, a tarefa de sincronização falhará. Nota Durante a sincronização completa, o DTS consulta o banco de dados de origem. Isso cria bloqueios de metadados que podem impedir operações DDL no banco de dados de origem. A instância PolarDB-X 1.0 de origem deve ser versão 5.2 ou posterior.
Outras limitações	A sincronização de objetos INDEX, PARTITION, VIEW, PROCEDURE, FUNCTION, TRIGGER e chave estrangeira (FK) não é suportada. A sincronização de dados de uma instância PolarDB-X 1.0 é um processo distribuído. Uma subtarefa é criada para cada instância ApsaraDB RDS for MySQL anexada. Visualize o status de cada subtarefa na topologia da tarefa. Se a instância ApsaraMQ for Kafka de destino for redimensionada durante a sincronização, reinicie a tarefa de sincronização de dados. A sincronização incremental de dados depende de transações XA contínuas na instância PolarDB-X 1.0 de origem para garantir a consistência dos dados. Se essa continuidade for interrompida, por exemplo, ao modificar objetos de sincronização ou durante a recuperação de desastres do módulo de captura de dados incrementais, transações XA não confirmadas poderão ser perdidas. Execute a sincronização de dados fora dos horários de pico. A sincronização completa consome recursos de leitura e gravação nos bancos de dados de origem e destino, aumentando suas cargas. A sincronização completa executa operações INSERT simultâneas, o que pode causar fragmentação de tabelas no banco de dados de destino. Como resultado, o tablespace de destino fica maior que o de origem após a sincronização completa. Não utilize ferramentas como pt-online-schema-change para realizar alterações DDL online nos objetos de sincronização do banco de dados de origem. Caso contrário, a tarefa de sincronização falhará. Durante a sincronização de dados, não grave dados no banco de dados de destino usando ferramentas diferentes do DTS. Caso contrário, podem ocorrer inconsistências de dados. Por exemplo, se usar o DMS para realizar uma alteração DDL online enquanto outros dados estão sendo gravados no banco de dados de destino, pode haver perda de dados. Durante a sincronização completa e incremental, o DTS desativa temporariamente as verificações de restrições e as operações em cascata de chaves estrangeiras no nível da sessão. Se ocorrerem operações de atualização ou exclusão em cascata no banco de dados de origem enquanto a tarefa estiver em execução, poderá haver inconsistência de dados. Se uma tarefa falhar, a equipe de suporte do DTS tentará restaurá-la dentro de oito horas. Durante a restauração, eles podem reiniciar a tarefa ou ajustar seus parâmetros. Nota Apenas os parâmetros da tarefa DTS são modificados — não os parâmetros do banco de dados. Os parâmetros que podem ser ajustados incluem aqueles listados em {{XREF_5}}.

Topologias de sincronização

Sincronização unidirecional um para um
Sincronização unidirecional um para muitos
Sincronização unidirecional em cascata
Sincronização unidirecional muitos para um

Para uma introdução a essas topologias de sincronização e suas considerações, consulte {{XREF_6}}.

Operações SQL suportadas

Tipo de operação	Instrução SQL
DML	INSERT, UPDATE e DELETE

Permissões da conta do banco de dados

Banco de dados	Permissões necessárias	Ações
Instância PolarDB-X 1.0 de origem	Permissão de leitura nos objetos a serem sincronizados.	{{XREF_7}}

Precauções

Procedimento

Acesse a página da lista de tarefas de sincronização da região de destino. Utilize um dos dois métodos abaixo:
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 {{XREF_8}} e {{XREF_9}}.
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.
Clique em Create Task para abrir a página de configuração da tarefa.

Configure os bancos de dados de origem e de destino.

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 único.
Source Database	Select Existing Connection	Para usar uma instância de banco de dados que esteja {{XREF_10}} (recém-criada ou salva), selecione a instância 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ê ainda 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-X 1.0.
	Connection Type	Selecione Alibaba Cloud Instance.
	Instance Region	Selecione a região onde reside a instância PolarDB-X 1.0 de origem.
	Cross-account	Se estiver sincronizando dados dentro da mesma conta Alibaba Cloud, selecione No.
	Instance ID	Selecione o ID da instância PolarDB-X 1.0 de origem.
	Database Account	Insira a conta do banco de dados da instância PolarDB-X 1.0 de origem. Para informações sobre as permissões necessárias, consulte {{XREF_11}}.
	Database Password	Insira a senha correspondente à conta do banco de dados.
Destination Database	Select Existing Connection	Para usar uma instância de banco de dados que esteja {{XREF_12}} (recém-criada ou salva), selecione a instância 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ê ainda 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, configure a instância de sincronização tratando a instância ApsaraMQ for Kafka como se fosse um banco de dados Kafka autogerenciado.
	Instance Region	Selecione a região onde reside a instância ApsaraMQ for Kafka de destino.
	Connected VPC	Selecione o ID da Virtual Private Cloud (VPC) onde a instância ApsaraMQ for Kafka de destino está localizada. Encontre o ID da VPC na página Basic Information da instância ApsaraMQ for Kafka.
	Domain Name or IP	Insira um endereço IP do Default Endpoint da instância ApsaraMQ for Kafka. Nota Encontre o endereço IP do Default Endpoint na página Basic Information da instância ApsaraMQ for Kafka.
	Port	A porta de serviço da instância ApsaraMQ for Kafka. O valor padrão é 9092.
	Database Account	Insira a conta e a senha do banco de dados da instância ApsaraMQ for Kafka de destino. Nota Forneça conta e senha apenas para instâncias ApsaraMQ for Kafka com Listas de Controle de Acesso (ACLs) ativadas. Para mais informações, consulte {{XREF_13}}.
	Database Password
	Kafka Version	Selecione a versão da sua instância ApsaraMQ for Kafka.
	Connection Method	Selecione Non-encrypted ou SCRAM-SHA-256 conforme seus requisitos de negócios e segurança.
	Topic	Na lista suspensa, selecione o tópico para receber os dados.
	Use Kafka Schema Registry	O Kafka Schema Registry é uma camada de serviço para seus metadados. Ele fornece uma API RESTful para armazenar e recuperar seus schemas Avro. No: Não utiliza o Kafka Schema Registry. Yes: Utiliza o Kafka Schema Registry. Insira a URL ou o endereço IP do schema Avro registrado no Kafka Schema Registry.

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 DTS foram adicionados às configurações de segurança dos bancos de dados de origem e destino para permitir o acesso desses servidores. Isso pode ser feito automática ou manualmente. Para mais informações, consulte {{XREF_14}}.
- Se o banco de dados de origem ou de destino for autogerenciado (onde o Access Method não é Alibaba Cloud Instance), clique também em Test Connectivity na caixa de diálogo CIDR Blocks of DTS Servers.

Configure os objetos da tarefa.

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

Parâmetro	Descrição
Synchronization Types	A opção Incremental Data Synchronization vem selecionada. Por padrão, selecione também Schema Synchronization e Full Data Synchronization. Após a pré-verificação, o DTS realiza uma sincronização completa dos dados dos objetos selecionados da instância de origem para o cluster de destino. Isso serve como base para a subsequente sincronização incremental de dados. Nota Se selecionar Full Data Synchronization, o schema e os dados das tabelas para as quais uma instrução CREATE TABLE foi executada poderão ser sincronizados com o banco de dados de destino.
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, a pré-verificação é aprovada. Se existir, a pré-verificação falha e a tarefa de sincronização não inicia. Nota Caso não seja possível excluir ou renomear a tabela homônima no banco de dados de destino, mapeie-a para um nome diferente. Para mais informações, consulte {{XREF_15}}. Ignore Errors and Proceed: Ignora a verificação de nomes de tabelas duplicadas 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 schemas das tabelas forem iguais e um registro no banco de dados de destino tiver o mesmo valor de chave primária ou ú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 sobrescreve o registro no banco de dados de destino. Se os schemas das tabelas forem diferentes, a sincronização inicial de dados poderá falhar. Isso pode resultar na sincronização parcial dos dados das colunas ou em uma falha completa. Prossiga com cautela.
Data Format in Kafka	Selecione o formato de armazenamento para os dados sincronizados na instância ApsaraMQ for Kafka. Se selecionar DTS Avro, analise os dados com base na definição de schema DTS Avro. Para mais informações, consulte definição de schema DTS Avro e exemplo de desserialização DTS Avro. Se selecionar Canal JSON, consulte {{XREF_16}} para descrições de parâmetros e exemplos. Nota O PolarDB-X 1.0 não suporta Canal JSON. Selecione DTS Avro.
Kafka Data Compression Format	Selecione o formato de compressão para mensagens Kafka conforme suas necessidades de negócios. LZ4 (padrão): Baixa taxa de compressão, mas alta velocidade. GZIP: Alta taxa de compressão, mas baixa velocidade. Nota O consumo de CPU é elevado. Snappy: Taxa e velocidade de compressão médias.
Policy for Shipping Data to Kafka Partitions
Message acknowledgement mechanism	Selecione um {{XREF_18}} conforme suas necessidades de negócios.
Topic That Stores DDL Information	Na lista suspensa, selecione o tópico usado para armazenar informações DDL. Nota Se não 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	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 na instância de destino. Por padrão, a DTS default policy vem selecionada. Também é possível optar pelas políticas padrão dos bancos de dados de origem e destino. Para mais informações, consulte {{XREF_19}}.
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 Recomendamos selecionar tabelas como objetos de sincronização. Se selecionar um banco de dados inteiro, as alterações para adicionar ou excluir tabelas nesse banco não serão sincronizadas com o banco de dados de destino.
Selected Objects	Utilize 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 ApsaraMQ for Kafka de destino. Para mais informações, consulte {{XREF_20}}. Nota Ao usar o recurso de mapeamento de nomes de objetos, a sincronização de outros objetos dependentes do objeto mapeado poderá falhar. Para selecionar as operações SQL para sincronização incremental de dados, clique com o botão direito no objeto na caixa Selected Objects e selecione as operações desejadas na caixa de diálogo.

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, sem necessidade de seleção. Para um desempenho mais estável, adquira um cluster dedicado para executar tarefas de sincronização do DTS. Para mais informações, consulte {{XREF_21}}.
Retry Time for Failed Connections	Após o início da tarefa de sincronização, se a conexão com o banco de dados de origem ou destino falhar, o DTS reportará um erro e iniciará imediatamente novas tentativas de conexão. A duração padrão de nova tentativa é de 720 minutos. Especifique uma duração personalizada entre 10 e 1.440 minutos. Recomendamos definir a duração para 30 minutos ou mais. Se o DTS reconectar com sucesso ao banco de dados dentro do período especificado, a tarefa de sincronização será retomada automaticamente. Caso contrário, a tarefa falhará. Nota Se houver várias instâncias DTS (por exemplo, Instância A e Instância B) compartilhando a mesma origem ou destino, e o tempo de nova tentativa de rede for definido como 30 minutos para a Instância A e 60 minutos para a Instância B, a menor duração 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 conforme suas necessidades ou liberar a instância DTS assim que possível após a liberação das instâncias de banco de dados de origem e 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 destino (como exceções na execução de DDL ou DML), o DTS reportará um erro e iniciará imediatamente operações contínuas de nova tentativa. A duração padrão é de 10 minutos. Personalize a duração 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 definida, a tarefa de sincronização será retomada automaticamente. Caso contrário, a tarefa falhará. Importante O valor de Retry Time for Other Issues deve ser menor que o de 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 destino, o que pode aumentar a carga do banco de dados. Para reduzir essa carga, 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 estiver definido como Full Data Synchronization. Também é possível {{XREF_22}} depois que a instância de sincronização estiver em execução.
Enable Throttling for Incremental Data Synchronization	Defina também um limite de taxa para a tarefa de sincronização incremental. Para aliviar a pressão no banco de dados de destino, configure RPS of Incremental Data Synchronization e Data synchronization speed for incremental synchronization (MB/s).
Environment Tag	Selecione uma tag de ambiente para identificar a instância. Isso não é obrigatório para este exemplo.
Configure ETL	Escolha se deseja ativar o recurso de extração, transformação e carregamento (ETL). Para mais informações, consulte {{XREF_23}} 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 {{XREF_24}}. 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 e especificando um notificação de alerta. Para mais informações, consulte {{XREF_25}}.

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.
- Após terminar 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 a aprovação de todos os itens.
- Se a pré-verificação falhar, clique em View Details para o item com falha. Corrija o problema conforme indicado 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, clique em Confirm Alert Details, Ignore, OK e Precheck Again em sequência para pular o aviso e executar a pré-verificação novamente. Optar por ocultar o item de aviso pode causar problemas como inconsistência de dados e representar riscos aos seus negócios.

Adquira a instância.

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

Na página Purchase, selecione o método de faturamento e a especificação do 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: Pagamento realizado na criação da 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: Cobrança horária. Adequado para necessidades de curto prazo. Libere 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 {{XREF_26}}.
	Especificação do Link	O DTS oferece 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 baseada no seu cenário de negócios. Para mais informações, consulte {{XREF_27}}.
	Duração da Assinatura	No modo assinatura, selecione a duração e a quantidade para a instância. Escolha 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.

Após concluir a configuração, leia e selecione Data Transmission Service (Pay-as-you-go) Service Terms.
Clique em Buy and Start. Na caixa de diálogo OK, clique em OK.

Visualize o progresso da tarefa na página Data Synchronization.

Informações de mapeamento

Na área Selected Objects, passe o mouse sobre o nome do tópico de destino (no nível da tabela).
Clique em Edit que aparece ao lado do nome do tópico de destino.

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 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, não será possível 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 especificado 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 Kafka autogerenciado e a tarefa incluir sincronização de schema, o DTS tentará criar o tópico especificado no banco de dados de destino. Se modificar o Name of target Topic, os dados serão gravados no tópico especificado.
Filter Conditions	Para mais informações, consulte {{XREF_28}}.
Number of Partitions	O número de partições ao gravar dados no tópico de destino.
Partition Key	Quando a Policy for Shipping Data to Kafka Partitions estiver definida como Ship Data to Separate Partitions Based on Hash Values of Primary Keys, configure este parâmetro. Especifique uma ou mais colunas como Partition Key para calcular o valor hash. O DTS então entregará linhas em diferentes partições do tópico de destino com base nos valores hash calculados. Nota Selecione a Partition Key apenas na caixa de diálogo Edit Table.

Clique em Edit Table.

Perguntas frequentes

Posso modificar o OK?

Sim. Utilize o recurso {{XREF_29}} para modificá-lo.
Posso modificar o Kafka Data Compression Format?

Sim. Utilize o recurso {{XREF_30}} para modificá-lo.