Todos os produtos
Search
Central de documentação

Data Transmission Service:Sincronizar PolarDB-X 2.0 para DataHub

Última atualização: Aug 26, 2026

O Data Transmission Service (DTS) permite sincronizar dados incrementais do PolarDB-X 2.0 para o DataHub em tempo real.

Pré-requisitos

Limitações

Tipo

Descrição

Limitações do banco de dados de origem

  • As tabelas sincronizadas devem possuir uma chave primária ou uma restrição única. Caso contrário, podem ocorrer dados duplicados no banco de dados de destino.

  • O DTS não suporta instâncias somente leitura do PolarDB-X 2.0 Enterprise Edition como banco de dados de origem.

  • Ao sincronizar tabelas individualmente e realizar edições, como mapeamento de nomes de colunas, uma única tarefa de sincronização de dados suporta no máximo 5.000 tabelas. Para sincronizar mais de 5.000 tabelas, divida-as em várias tarefas ou configure a tarefa para sincronizar todo o banco de dados. Caso contrário, pode ocorrer um erro de solicitação após o envio da tarefa.

  • Requisitos de binary log:

    • É necessário ativar o recurso de binary log no console do PolarDB-X 2.0 e definir o parâmetro binlog_row_image como full. Para mais informações, consulte Parameter settings. Sem essa configuração, a pré-verificação falha e a tarefa de sincronização de dados não inicia.

    • Para uma tarefa de sincronização incremental de dados, os binary logs do banco de dados de origem devem ser retidos por pelo menos 24 horas. Em tarefas que incluem sincronização de esquema e sincronização incremental, a retenção mínima exigida é de 7 dias. Após a conclusão da sincronização de esquema, o período de retenção pode ser reduzido para no mínimo 24 horas. Se a retenção for insuficiente, o DTS pode não conseguir obter os binary logs, causando falha na tarefa e possíveis inconsistências ou perda de dados. Problemas decorrentes de retenção inferior ao necessário não são cobertos pelo SLA do DTS.

  • O DTS não oferece suporte à sincronização de grupos de tabelas (TABLEGROUP) nem de bancos de dados e tabelas com o atributo Locality.

  • Não é possível sincronizar tabelas cujos nomes sejam palavras-chave reservadas, como select.

  • Durante a sincronização de esquema, evite executar qualquer operação DDL que altere o esquema do banco de dados ou da tabela. Do contrário, a tarefa de sincronização de dados falhará.

  • O DTS não consegue sincronizar partições de bancos de dados no modo DRDS em uma instância PolarDB-X 2.0.

Outras limitações

  • Somente a sincronização de dados no nível de tabela é suportada.

  • O comprimento máximo para um único campo String no DataHub de destino é de 2 MB.

  • Evite usar ferramentas como pt-online-schema-change para executar operações DDL online nos objetos sendo sincronizados no banco de dados de origem. Essa ação causa falha na tarefa de sincronização.

  • Durante a sincronização de dados, impeça que outros aplicativos ou processos gravem no banco de dados de destino. Essa precaução evita inconsistências e possíveis perdas de dados. Por exemplo, se outro processo gravar no destino enquanto o DTS sincroniza dados, pode haver perda de informações.

  • A sincronização completa de dados não é suportada. O DTS não replica dados históricos da instância de origem do PolarDB-X 2.0 para a instância de destino do DataHub.

  • Em caso de falha na tarefa, a equipe de suporte do DTS tentará restaurá-la dentro de oito horas. Durante a restauração, a tarefa pode ser reiniciada ou ter seus parâmetros ajustados.

    Nota

    Apenas parâmetros da tarefa DTS são modificados — não os parâmetros do banco de dados. Os parâmetros passíveis de ajuste incluem aqueles listados em Modify instance parameters.

Outras precauções

Periodicamente, o DTS atualiza a tabela dts_health_check.ha_health_check no banco de dados de origem para avançar a posição do binary log.

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 sobre topologias de sincronização e suas considerações, consulte Synchronization topologies.

Operações SQL suportadas

Tipo de operação

Instrução SQL

DML

INSERT, UPDATE, DELETE

DDL

ADD COLUMN

Importante

Caso modifique manualmente a estrutura da tabela no banco de dados de destino, reinicie a tarefa: pause e depois start a tarefa.

Precauções

Procedimento

  1. 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 conforme o modo e o 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.

    Categoria

    Parâmetro

    Descrição

    N/A

    Task Name

    O DTS gera automaticamente um nome para a tarefa. Recomenda-se especificar um nome descritivo para facilitar a identificação. O nome não precisa ser exclusivo.

    Source Database

    Select Existing Connection

    • Para utilizar uma instância de banco de dados que esteja added to the system (recém-criada ou salva), selecione-a 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..

    • Caso não tenha adicionado a instância de banco de dados ao sistema, ou se não precisar usar uma instância já adicionada, configure manualmente as seguintes informações do banco de dados.

    Database Type

    Selecione PolarDB-X 2.0.

    Connection Type

    Selecione Alibaba Cloud Instance.

    Instance Region

    Selecione a região onde a instância de origem do PolarDB-X 2.0 está localizada.

    Replicate Data Across Alibaba Cloud Accounts

    Este exemplo sincroniza dados dentro da mesma conta Alibaba Cloud. Selecione No.

    Instance ID

    Selecione o ID da instância de origem do PolarDB-X 2.0.

    Database Account

    Insira a conta do banco de dados da instância de origem do PolarDB-X 2.0. A conta deve ter as permissões REPLICATION SLAVE, REPLICATION CLIENT e SELECT sobre os objetos que você está sincronizando.

    Nota

    Para informações sobre como conceder permissões, consulte Account permission issues during data synchronization.

    Database Password

    Insira a senha correspondente à conta do banco de dados.

    Destination Database

    Select Existing Connection

    • Para utilizar uma instância de banco de dados que esteja added to the system (recém-criada ou salva), selecione-a 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..

    • Caso não tenha adicionado a instância de banco de dados ao sistema, ou se não precisar usar uma instância já adicionada, configure manualmente as seguintes informações do banco de dados.

    Database Type

    Selecione DataHub.

    Connection Type

    Selecione Alibaba Cloud Instance.

    Instance Region

    Selecione a região onde a instância de destino do DataHub está localizada.

    Project

    Selecione o Project de destino do DataHub.

  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 DTS estejam adicionados às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso desses servidores. 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.

  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 vem selecionada por padrão. É possível selecionar apenas Schema Synchronization. A opção Full Data Synchronization não é suportada.

      Nota

      Durante a fase de inicialização da tarefa de sincronização de dados, o DTS sincroniza as definições de esquema dos objetos de sincronização, como esquemas de tabelas, para a instância de destino do DataHub.

      Naming Rules of Additional Columns

      O DTS adiciona colunas extras ao tópico de destino durante a sincronização. Se esses nomes de coluna entrarem em conflito com colunas existentes no tópico de destino, a tarefa de sincronização falhará. Defina Naming Rules of Additional Columns como New Rule ou Previous Rule conforme suas necessidades de negócio.

      Aviso

      Antes de escolher uma regra, avalie se os nomes das colunas adicionais entram em conflito com colunas existentes no tópico de destino. Caso contrário, a tarefa poderá falhar ou haver perda de dados. Para mais informações, consulte Names and definitions of additional columns.

      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 inicia.

        Nota

        Caso não seja possível excluir ou renomear a tabela homônima no banco de dados de destino, você pode mapeá-la para um nome diferente. Para mais informações, consulte Map table and column names.

      • Ignore Errors and Proceed: Ignora a verificação de nomes de tabela duplicados no banco de dados de destino.

        Aviso

        Selecionar Ignore Errors and Proceed pode causar inconsistência de dados e colocar seu negócio 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 sobrescreve o registro no banco de dados de destino.

        • Se os esquemas das tabelas forem diferentes, a sincronização inicial de dados pode falhar. Isso pode resultar na sincronização parcial dos dados das colunas ou em uma falha completa da sincronização. Prossiga com cautela.

      Capitalization of Object Names in Destination Instance

      É possível configurar a política de diferenciação entre 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 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

      Somente tabelas podem ser selecionadas como objetos a serem sincronizados.

      Selected Objects

      • Para renomear um único objeto de sincronização na instância de destino, clique com o botão direito no objeto dentro da caixa Selected Objects. Para mais informações sobre como renomear objetos, consulte Map a single database, table, or column.

      • Para alterar em lote os nomes de vários objetos de sincronização na instância de destino, clique em Batch Edit no canto superior direito da caixa Selected Objects. Para mais informações, consulte Map databases, tables, and columns in a batch.

      Nota

      Para filtrar dados usando uma cláusula WHERE, clique com o botão direito na tabela que deseja sincronizar no painel Selected Objects. Na caixa de diálogo exibida, especifique a condição de filtro. Para mais informações, consulte Filter synchronized data by using SQL conditions.

    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, sem necessidade de seleção. Para obter 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?.

      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 relatará um erro e iniciará imediatamente novas tentativas de conexão. A duração padrão de tentativa é de 720 minutos. Também é possível especificar uma duração personalizada entre 10 e 1.440 minutos. Recomenda-se definir esse valor como 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 múltiplas 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á aplicada a ambas.

      • Como o DTS cobra pelo tempo de execução da tarefa durante o período de nova tentativa de conexão, recomenda-se personalizar a duração conforme as necessidades do negócio 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 relatará um erro e iniciará imediatamente operações contínuas de nova tentativa. A duração padrão é de 10 minutos. É possível personalizar esse intervalo entre 1 e 1.440 minutos. Recomenda-se definir um valor igual ou superior a 10 minutos. Se as operações relevantes forem bem-sucedidas dentro do período configurado, 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 valor de Retry Time for Failed Connections.

      Enable Throttling for Incremental Data Synchronization

      Também é possível definir um limite de taxa para a tarefa de sincronização incremental. Para aliviar a pressão sobre o banco de dados de destino, configure 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 DTS estiver 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 DTS relate 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

      Selecione uma tag de ambiente para identificar a instância. Neste exemplo, esse parâmetro não é obrigatório.

      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:

      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.

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

    • Para visualizar os parâmetros da API referentes à configuração desta instância, passe o mouse sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters no balão exibido.

    • 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ó começa após a aprovação de todos os itens dessa verificação.

    • Se a pré-verificação falhar, clique em View Details referente ao item com falha. Corrija o problema conforme indicado e execute a pré-verificação novamente.

    • Caso a pré-verificação retorne 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 sequencialmente em Confirm Alert Details, Ignore, OK e Precheck Again para pular o aviso e reexecutar a pré-verificação. Optar por suprimir o item de aviso pode causar problemas como inconsistência de dados e representar riscos ao seu negócio.

  7. Adquira a instância.

    1. Quando a Success Rate atingir 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: O pagamento ocorre no momento da criação da instância. Ideal para necessidades de longo prazo, sendo 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 demandas de curto prazo. Libere a instância logo 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 de 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 transferência. Escolha uma especificação adequada ao seu cenário de negócios. Para mais informações, consulte Data synchronization link specifications.

      Duração da Assinatura

      No modo assinatura, selecione a duração e a quantidade desejadas. É possível escolher uma assinatura mensal de 1 a 9 meses, ou anual de 1, 2, 3 ou 5 anos.

      Nota

      Esta opção só está disponível quando o método de faturamento for 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.

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

Esquema do tópico DataHub

Ao sincronizar dados incrementais para um tópico DataHub, o DTS adiciona colunas de metadados ao tópico.

Neste exemplo, id , name e address são campos de dados. Quando as regras de nomenclatura anteriores são utilizadas, o DTS adiciona o prefixo dts_ a todos os campos, incluindo os originais da origem. Já com as novas regras de nomenclatura, o DTS não adiciona prefixo aos campos originais da origem.

Topic定义

Nome anterior da coluna

Novo nome da coluna

Tipo

Descrição

dts_record_id

new_dts_sync_dts_record_id

String

ID exclusivo da entrada de log incremental. Incrementa automaticamente a cada nova entrada. Em cenários de recuperação de desastres, rollbacks podem causar duplicação de ID. Para operações UPDATE, ambas as entradas de log (pré-atualização e pós-atualização) compartilham o mesmo dts_record_id.

dts_operation_flag

new_dts_sync_dts_operation_flag

String

O tipo de operação. Valores válidos: I (INSERT), D (DELETE), U (UPDATE), F (sincronização completa de dados).

dts_instance_id

new_dts_sync_dts_instance_id

String

O ID do servidor do banco de dados.

dts_db_name

new_dts_sync_dts_db_name

String

O nome do banco de dados.

dts_table_name

new_dts_sync_dts_table_name

String

O nome da tabela.

dts_utc_timestamp

new_dts_sync_dts_utc_timestamp

String

O timestamp da operação em UTC. Corresponde também ao timestamp do arquivo de log.

dts_before_flag

new_dts_sync_dts_before_flag

String

Indica se os valores da linha correspondem ao estado pré-atualização. Valores válidos: Y, N. Consulte a tabela de valores das flags antes e depois.

dts_after_flag

new_dts_sync_dts_after_flag

String

Indica se os valores da linha correspondem ao estado pós-atualização. Valores válidos: Y, N. Consulte a tabela de valores das flags antes e depois.

Valores das flags antes e depois

As colunas dts_before_flag e dts_after_flag indicam se uma linha no tópico representa o estado anterior ou posterior a uma alteração de dados.

Operação

Entradas de log geradas

dts_before_flag

dts_after_flag

Conteúdo da linha

INSERT

1

N

Y

Os valores recém-inseridos.

DELETE

1

Y

N

Os valores excluídos.

UPDATE (primeira entrada)

2 (mesmo dts_record_id)

Y

N

Valores pré-atualização.

UPDATE (segunda entrada)

2 (mesmo dts_record_id)

N

Y

Valores pós-atualização.

Operação INSERT

A entrada de log contém os valores recém-inseridos. dts_before_flag é N e dts_after_flag é Y.

Operação UPDATE

O DTS gera duas entradas de log com os mesmos valores de dts_record_id, dts_operation_flag e dts_utc_timestamp. A primeira entrada captura os valores pré-atualização (dts_before_flag=Y, dts_after_flag=N). A segunda entrada captura os valores pós-atualização (dts_before_flag=N, dts_after_flag=Y).

UPDATE操作

Operação DELETE

A entrada de log contém os valores excluídos. dts_before_flag é Y e dts_after_flag é N.

DELETE操作