Todos os produtos
Search

Este produto

    Data Transmission Service:Migrar PolarDB for MySQL para o DataHub

    Central de documentação

    Data Transmission Service:Migrar PolarDB for MySQL para o DataHub

    Última atualização: Sep 20, 2026

    Use o Data Transmission Service (DTS) para migrar dados de um cluster PolarDB for MySQL para um projeto do DataHub.

    Pré-requisitos

    • Crie um projeto do DataHub de destino. Para mais informações, consulte Quick start.

    • Ative o DataHub e crie um projeto para receber os dados migrados. Para mais informações, consulte Quick start e gerencie projetos.

    • O projeto do DataHub de destino deve ter mais espaço de armazenamento do que o cluster PolarDB for MySQL de origem utiliza atualmente.

    Limitações

    Nota

    O DTS não migra chaves estrangeiras. Como resultado, operações em cascata, como a exclusão em cascata no banco de dados de origem, não são replicadas no banco de dados de destino.

    Categoria

    Descrição

    Limitações do banco de dados de origem

    • Requisitos de largura de banda: o servidor que hospeda o banco de dados de origem deve ter largura de banda de saída suficiente. Caso contrário, isso afetará a velocidade de migração de dados.

    • As tabelas a serem migradas devem ter uma chave primária ou uma restrição de unicidade, e os valores nas colunas devem ser exclusivos. Caso contrário, dados duplicados poderão aparecer no banco de dados de destino.

    • Se você migrar dados no nível da tabela e precisar editar mapeamentos de colunas, uma única tarefa de migração de dados suporta no máximo 1.000 tabelas. Para migrar mais tabelas, recomendamos dividi-las em várias tarefas ou configurar uma tarefa para migrar o banco de dados inteiro. Caso contrário, poderá ocorrer um erro de solicitação após o envio da tarefa. Se necessário, envie a tarefa novamente.

    • Se você executar a migração incremental:

      • Ative o log binário e defina o parâmetro loose_polar_log_bin como on. Caso contrário, a pré-verificação relatará um erro e a tarefa de migração de dados não poderá ser iniciada. Para mais informações sobre como ativar o log binário e modificar parâmetros, consulte Enable binary logging e modifique parâmetros.

        Nota

        Ativar o log binário para um cluster PolarDB for MySQL consome espaço de armazenamento e gera taxas de armazenamento.

      • Os logs binários do cluster PolarDB for MySQL devem ser retidos por pelo menos 3 dias. Recomendamos um período de retenção de 7 dias. Caso contrário, o DTS poderá falhar ao obter os logs binários, causando a falha da tarefa. Em casos extremos, isso pode levar à inconsistência ou à perda de dados. O SLA do DTS não cobre problemas causados por um período de retenção de log binário inferior ao requisito do DTS.

        Nota

        Para mais informações sobre como definir o período de retenção para logs binários de um cluster PolarDB for MySQL, consulte modifique o período de retenção.

    • Não execute operações DDL que alterem o schema de um banco de dados ou tabela durante a migração de schema. Caso contrário, a tarefa de migração de dados falhará.

    Outras limitações

    • Um único campo String no DataHub pode ter até 2 MB de tamanho.

    • Há suporte apenas para migração de dados no nível da tabela. Se você adicionar uma coluna a uma tabela de origem em migração, os dados dessa nova coluna não serão migrados.

    • Não há suporte para a migração de dados do tipo VECTOR.

    • O DTS não migra nós somente leitura de um cluster PolarDB for MySQL de origem.

    • O DTS não oferece suporte à migração de tabelas externas do OSS a partir da instância PolarDB for MySQL de origem.

    • O DTS não oferece suporte a cenários de failover primário/standby para a instância de banco de dados durante a migração completa de dados. Nesse cenário, reconfigure a tarefa de migração imediatamente.

    • A migração completa de dados consome recursos de leitura e gravação nos bancos de dados de origem e de destino, o que pode aumentar a carga deles. Recomendamos avaliar o desempenho de ambos os bancos de dados e executar a migração em horários de menor movimento.

    • Para colunas do tipo de dados FLOAT ou DOUBLE, o DTS usa ROUND(COLUMN,PRECISION) para ler valores. Se você não definir explicitamente a precisão, o DTS usa uma precisão de migração padrão de 38 dígitos para FLOAT e 308 dígitos para DOUBLE. Certifique-se de que a precisão atenda aos seus requisitos.

    • O DTS tenta retomar uma tarefa de migração com falha em até sete dias. Antes de executar um failover de carga de trabalho para a instância de destino, pare ou libere a instância de migração. Como alternativa, execute o comando REVOKE para revogar as permissões de gravação da conta que o DTS usa para acessar a instância de destino. Isso impede que a tarefa seja retomada automaticamente e sobrescreva dados na instância de destino.

    • Não use ferramentas como pt-online-schema-change para executar operações DDL online em objetos de migração no banco de dados de origem. Caso contrário, a migração falhará.

    • Se uma tarefa falhar, a equipe de suporte do DTS tentará restaurá-la em até oito horas. Durante a restauração, eles podem reiniciar a tarefa ou ajustar seus parâmetros.

      Nota

      Apenas os parâmetros da tarefa do DTS são modificados, e não os parâmetros do banco de dados. Os parâmetros que podem ser ajustados incluem aqueles listados em modifique parâmetros da instância.

    Outras observações

    O DTS executa periodicamente o comando CREATE DATABASE IF NOT EXISTS test no banco de dados de origem para avançar a posição do log binário.

    Faturamento

    Tipo de migração

    Taxa de configuração da instância

    Taxa de tráfego de internet

    Migração de schema e migração completa de dados

    Gratuito.

    Quando o parâmetro Access Method do banco de dados de destino é definido como Public IP Address, há cobrança de tráfego de internet. Para mais informações, consulte Billing overview.

    Migração incremental de dados

    Pago. Para mais informações, consulte Billing overview.

    Tipos de migração

    • Migração de schema

      O DTS migra as definições de schema dos objetos de migração do banco de dados de origem para o banco de dados de destino.

    • Migração incremental

      Após a conclusão de uma migração completa, o DTS migra atualizações incrementais de dados do banco de dados de origem para o banco de dados de destino. A migração incremental permite migrar dados de forma suave, sem interromper suas aplicações autogerenciadas.

    Operações SQL para migração incremental

    Tipo de operação

    Instrução SQL

    DML

    INSERT, atualize, DELETE

    DDL

    ADD COLUMN

    Importante

    Se você modificar manualmente a estrutura da tabela no banco de dados de destino, reinicie a tarefa: pause e, em seguida, start a tarefa.

    Permissões necessárias para contas de banco de dados

    Banco de dados

    Permissões necessárias

    Conta e permissões

    Cluster PolarDB for MySQL

    Permissões de leitura nos objetos de migração

    crie e gerencie contas de banco de dados

    Procedimento

    1. Por favor, acesse a página da lista de tarefas de migração para a região de destino usando um dos seguintes métodos.

      A partir do console do DTS

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

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

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

      A partir do console do DMS

      Nota

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

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

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

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

    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/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 DMS Database Instance

      Selecione uma instância existente conforme necessário.

      • Se você usar uma instância existente, as informações do banco de dados serão preenchidas automaticamente. Não é necessário inseri-las novamente.

      • Se não usar uma instância existente, insira 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 onde reside a instância PolarDB for MySQL de origem.

      Cross-account

      Este exemplo migra dados dentro da mesma conta da 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 da instância PolarDB for MySQL de origem. Para obter informações sobre as permissões necessárias, consulte Permissions required for database accounts.

      Database Password

      insira a senha da conta do banco de dados.

      Encryption

      Selecione um tipo de conexão conforme necessário. Para mais informações sobre o recurso de criptografia SSL, consulte Enable SSL encryption.

      Destination Database

      Select DMS Database Instance

      Selecione uma instância existente conforme necessário.

      • Se você usar uma instância existente, as informações do banco de dados serão preenchidas automaticamente. Não é necessário inseri-las novamente.

      • Se não usar uma instância existente, insira as seguintes informações do banco de dados.

      Database Type

      Selecione DataHub.

      Access Method

      Selecione Alibaba Cloud Instance.

      Instance Region

      Selecione a região onde reside o projeto do DataHub de destino.

      Project

      Selecione o ID do projeto do DataHub de destino.

    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 intervalos de endereços IP do serviço DTS sejam adicionados automática ou manualmente às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso dos servidores do DTS. Para mais informações, consulte Add DTS server IP addresses to a whitelist.

    5. Configure os objetos da tarefa.

      1. Na página Configure Objects, configure os objetos que deseja migrar.

        Parâmetro

        Descrição

        Migration Types

        • Se você precisar apenas executar uma migração completa, selecione Schema Migration e Full Data Migration.

        • Execute uma migração sem tempo de inatividade, selecione Schema Migration, Full Data Migration e Incremental Data Migration.

        Nota

        • Se você não selecionar Schema Migration, garanta a existência de um banco de dados e tabelas para receber os dados no banco de dados de destino. Você também pode usar o recurso de mapeamento de nomes de objetos na caixa Selected Objects conforme necessário.

        • Se não selecionar Incremental Data Migration, não grave novos dados na instância de origem durante a migração de dados para garantir a consistência dos dados.

        Naming Rules of Additional Columns

        O DTS adiciona colunas às tabelas de destino durante a migração para o DataHub. Se esses nomes de colunas entrarem em conflito com os existentes, a migração falhará. Selecione New Rule ou Previous Rule com base nos requisitos do seu negócio.

        Aviso

        Antes de selecionar uma regra, verifique se os nomes das colunas adicionais entram em conflito com as colunas existentes nas tabelas de destino. Para mais informações sobre as regras e definições de colunas adicionais, consulte Names and definitions of additional columns.

        Processing Mode for Existing Destination Tables

        • Precheck and Report Errors: Verifica se existem tabelas com os mesmos nomes no banco de dados de destino. Se não existirem tabelas com os mesmos nomes, a pré-verificação será aprovada. Caso existam, um erro será relatado durante a pré-verificação e a tarefa de migração de dados não será iniciada.

          Nota

          Se uma tabela no banco de dados de destino tiver o mesmo nome, mas não puder ser excluída ou renomeada facilmente, altere o nome da tabela no banco de dados de destino. Para mais informações, consulte Object name mapping.

        • Ignore Errors and Proceed: Ignora a verificação de tabelas com os mesmos nomes.

          Aviso

          Selecionar Ignore Errors and Proceed pode causar inconsistência de dados e gerar riscos ao negócio. Por exemplo:

          • Se os schemas das tabelas forem consistentes e um registro no banco de dados de destino tiver o mesmo valor de chave primária que um registro no banco de dados de origem:

            • Durante a migração completa, o DTS mantém o registro no banco de dados de destino. O registro do banco de dados de origem não é migrado.

            • Durante a migração incremental, o DTS não mantém o registro no banco de dados de destino. O registro do banco de dados de origem sobrescreve o registro no banco de dados de destino.

          • Se os schemas das tabelas forem inconsistentes, apenas algumas colunas de dados poderão ser migradas ou a migração poderá falhar. Prossiga com cautela.

        Case Sensitivity Policy for Destination Object Names

        Configure a política de diferenciação de maiúsculas e minúsculas para nomes de bancos de dados, tabelas e colunas dos objetos de migração na instância de destino. Por padrão, DTS default policy está selecionado. Você também pode alinhar com a política padrão do banco de dados de origem ou de destino. Para mais informações, consulte Case sensitivity policy for destination object names.

        Source Objects

        Selecione um ou mais objetos na seção Source Objects. Clique no ícone Rightwards arrow e adicione os objetos à seção Selected Objects.

        Nota

        Selecione bancos de dados ou tabelas como objetos de migração. Se você selecionar tabelas, outros objetos, como visualizações, gatilhos e procedimentos armazenados, não serão migrados.

        Selected Objects

        • Para alterar o nome de um único objeto de migração na instância de destino, clique com o botão direito do mouse no objeto na caixa Selected Objects. Para mais informações, consulte Map individual schema, table, and column names.

        • Para alterar os nomes de vários objetos de migração na instância de destino, clique em Selected Objects no canto superior direito da caixa Batch Edit. Para mais informações, consulte Map multiple schema, table, and column names.

        Nota

        • Se você usar o mapeamento de nomes de objetos, a migração de outros objetos dependentes do objeto renomeado poderá falhar.

        • Para filtrar dados usando cláusulas WHERE, clique com o botão direito do mouse na tabela a ser migrada no painel Selected Objects e especifique as condições de filtro na caixa de diálogo exibida. Para mais informações, consulte defina condições de filtro.

        • Para selecionar operações SQL para migração no nível do banco de dados ou da tabela, clique com o botão direito do mouse no objeto de migração no painel Selected Objects e selecione as operações SQL desejadas na caixa de diálogo exibida.

        • Ao migrar no nível da tabela, defina a Shardkey (chave de particionamento) clicando com o botão direito do mouse na tabela no painel Selected Objects e desmarcando Sync All Columns na caixa de diálogo exibida.

      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. Não é necessário selecionar um. Se desejar tarefas mais estáveis, adquira um dedicated cluster para executar tarefas de migração do DTS.

        Retry Time for Failed Connections

        Após o início da tarefa de migração, se a conexão com o banco de dados de origem ou de destino falhar, o DTS relatará um erro e começará imediatamente a tentar reconectar. A duração padrão para novas tentativas é de 720 minutos. Personalize o tempo de nova tentativa para um valor entre 10 e 1440 minutos. Recomendamos definir a duração para mais de 30 minutos. Se o DTS se reconectar aos bancos de dados de origem e de destino dentro da duração especificada, a tarefa de migração será retomada automaticamente. Caso contrário, a tarefa falhará.

        Nota

        • Para várias instâncias do DTS que compartilham a mesma origem ou destino, o tempo de nova tentativa de rede é determinado pela configuração da última tarefa criada.

        • Como há cobrança pela tarefa durante o período de nova tentativa de conexão, recomendamos personalizar o tempo de 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 migração, se ocorrer um problema que não seja de conectividade, como uma exceção de execução DDL ou DML, no banco de dados de origem ou de destino, o DTS relatará um erro e começará imediatamente a tentar repetir a operação. A duração padrão para novas tentativas é de 10 minutos. Personalize o tempo de nova tentativa para um valor entre 1 e 1440 minutos. Recomendamos definir a duração para mais de 10 minutos. Se as operações relacionadas forem bem-sucedidas dentro da duração de nova tentativa especificada, a tarefa de migraçã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 Full Data Migration

        Durante a migração completa, o DTS consome recursos de leitura e gravação nos bancos de dados de origem e de destino, o que pode aumentar a carga do banco de dados. Se necessário, ative o limitador para a tarefa de migração completa. Defina Queries per second (QPS) to the source database, RPS of Full Data Migration e Data migration speed for full migration (MB/s) para reduzir a carga no banco de dados de destino.

        Nota

        • Este item de configuração está disponível apenas se você selecionar Full Data Migration para Migration Types.

        • Você também pode adjust the full migration speed após a instância de migração estar em execução.

        Enable Throttling for Incremental Data Migration

        Se necessário, defina limites de velocidade para a tarefa de migração incremental. Defina RPS of Incremental Data Migration e Data migration speed for incremental migration (MB/s) para reduzir a carga no banco de dados de destino.

        Nota

        • Este item de configuração está disponível apenas se você selecionar Incremental Data Migration para Migration Types.

        • Você também pode adjust the incremental migration speed após a instância de migração estar em execução.

        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 quando a instância do 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 do DTS relate 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

        Selecione uma tag de ambiente para identificar a instância. Não é necessário para este exemplo.

        Configure ETL

        Com base nas necessidades do seu negócio, selecione se deseja configurar o ETL feature para processar dados.

        Monitoring and Alerting

        Selecione se deseja definir alertas e receber notificações de alerta com base nas necessidades do seu negócio.

        • No: Não define um alerta.

        • Yes: Configure alertas definindo um alert threshold e um notificações de alerta. Se uma migração falhar ou a latência exceder o limiar, o sistema enviará uma notificação de alerta.

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

      • visualize os parâmetros de configuração desta instância ao chamar a operação da API, passe o ponteiro do mouse sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters na dica exibida.

      • Se não precisar visualizar ou já tiver terminado 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 da tarefa de migração, o DTS realiza uma pré-verificação. A tarefa só é iniciada após ser aprovada na pré-verificação.

      • Se a pré-verificação falhar, clique em View Details ao lado do item de verificação com falha, corrija o problema com base na instrução e execute a pré-verificação novamente.

      • Se um aviso for relatado durante a pré-verificação:

        • Para itens de verificação que não podem ser ignorados, clique em View Details ao lado do item com falha, corrija o problema com base na instrução 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 para pular o item de alerta e executar a pré-verificação novamente. Optar por ignorar um 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 for de 100%, clique em Next: Purchase Instance.

      2. Na página Purchase, selecione a especificação do link para a instância de migração de dados. Para mais informações, consulte a tabela a seguir.

        Categoria

        Parâmetro

        Descrição

        New Instance Class

        Resource Group Settings

        Selecione o grupo de recursos ao qual a instância pertence. O valor padrão é o grupo de recursos padrão. Para mais informações, consulte What is resource management?

        Instance Class

        O DTS fornece especificações de migração com diferentes níveis de desempenho. A especificação do link afeta a velocidade da migração. Selecione uma especificação com base no cenário do seu negócio. Para mais informações, consulte Data migration link specifications.

      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 exibida, clique em OK.

        visualize o progresso da tarefa de migração na página de lista Data Migration Tasks.

        Nota

        • Se a tarefa de migração não incluir migração incremental, ela será interrompida automaticamente após a conclusão da migração completa. Após a interrupção da tarefa, seu Status muda para Completed.

        • Se a tarefa de migração incluir migração incremental, ela não será interrompida automaticamente. A tarefa de migração incremental continua em execução. Enquanto a tarefa de migração incremental estiver em execução, o Status da tarefa será Running.