Migrate PolarDB-X 2.0 to AnalyticDB for PostgreSQL - Data Transmission Service: Central de Documentação do Alibaba Cloud

Pré-requisitos

Você deve ter uma instância PolarDB-X 2.0 de origem. Para mais informações, consulte Create an instance.
Você deve ter uma instância AnalyticDB for PostgreSQL de destino. Para mais informações, consulte Create an instance.
O espaço de armazenamento da instância AnalyticDB for PostgreSQL de destino deve ser superior ao espaço utilizado pela instância PolarDB-X 2.0 de origem.

Precauções

Tipo	Descrição
Limitações do banco de dados de origem	As tabelas a serem migradas devem ter uma PRIMARY KEY ou uma restrição UNIQUE, e os campos na chave ou restrição devem ser únicos. Caso contrário, podem ocorrer dados duplicados no banco de dados de destino. Instâncias somente leitura do PolarDB-X 2.0 Enterprise Edition não são suportadas como banco de dados de origem. Ao migrar objetos no nível de tabela com necessidade de edição, como mapeamento de nomes de colunas, uma única tarefa de migração de dados suporta no máximo 1.000 tabelas. Se esse limite for excedido, o envio da tarefa falhará. Nesse caso, divida as tabelas em várias tarefas de migração de dados ou configure uma tarefa para migrar todo o banco de dados. Para migração incremental de dados, o banco de dados de origem deve atender aos seguintes requisitos de binary log: Ative o recurso de binary log e defina o parâmetro `binlog_row_image` como `full`. Caso contrário, a pré-verificação falhará e a tarefa de migração de dados não poderá ser iniciada. Para tarefas de migração incremental, o DTS exige que os binary logs do banco de dados de origem sejam retidos por pelo menos 24 horas. Para tarefas que incluem migração completa e incremental, os binary logs devem ser retidos por pelo menos 7 dias. É possível alterar o período de retenção para 24 horas após a conclusão da migração completa. Se os binary logs não forem retidos pelo período necessário, o DTS pode falhar ao obtê-los, causando falhas na tarefa ou até mesmo inconsistência e perda de dados. O SLA do DTS não cobre problemas causados por um período insuficiente de retenção de binary logs. Limitações operacionais no banco de dados de origem: Durante a migração de esquema e a migração completa de dados, não execute operações DDL que alterem o esquema do banco de dados ou da tabela. Caso contrário, a tarefa de migração de dados falhará. Nota Durante a migração completa de dados, o DTS consulta o banco de dados de origem. Essa ação aplica um bloqueio de metadados, que pode impedir operações DDL no banco de dados de origem. Durante a migração completa e incremental, o DTS desativa temporariamente as verificações de restrições e 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, podem surgir inconsistências de dados. Caso seja necessário alterar o tipo de rede da instância PolarDB-X 2.0 durante a migração, atualize as informações de conexão de rede da tarefa de migração após a conclusão da alteração. Se você executar apenas a migração completa de dados, não grave novos dados no banco de dados de origem durante a migração. Caso contrário, haverá inconsistência de dados entre os bancos de dados de origem e de destino. Para manter a consistência dos dados em tempo real, selecione migração de esquema, migração completa de dados e migração incremental de dados. Não há suporte para a migração de grupos de tabelas (TABLEGROUP) e de bancos de dados ou tabelas com o atributo Locality. Não há suporte para a migração de tabelas cujos nomes são palavras reservadas, como `select`. Em uma instância PolarDB-X 2.0, partições de banco de dados no modo DRDS não são suportadas para sincronização. Durante a operação de uma tarefa de migração do DTS, não há suporte para a alteração do tipo de uma tabela de broadcast na instância PolarDB-X 2.0 de origem (por exemplo, alterar uma tabela de broadcast para uma tabela regular ou fragmentada). Para alterar o tipo da tabela, pare primeiro a tarefa de migração e reconfigure-a após a conclusão da alteração.
Outras limitações	Apenas a migração no nível de tabela é suportada. Tabelas AO não são suportadas como tabelas de destino. Os dados são perdidos nas colunas de origem que não existem na tabela de destino. Isso ocorre se você usar mapeamento de colunas ou se os esquemas das tabelas não corresponderem. Se uma tabela a ser migrada tiver uma chave primária, a coluna de chave primária na tabela de destino deve ser igual à da tabela de origem. Se a tabela a ser migrada não tiver uma chave primária, a coluna de chave primária na tabela de destino deve ser igual à chave de distribuição. A chave exclusiva da tabela de destino, incluindo a coluna de chave primária, deve conter todas as colunas da chave de distribuição. Antes de iniciar a migração de dados, avalie o desempenho dos seus bancos de dados de origem e de destino. Recomendamos migrar os dados fora dos horários de pico. Uma migração completa de dados consome recursos de leitura e gravação em ambos os bancos de dados, aumentando a carga sobre eles. O DTS tenta restaurar tarefas de migração com falha dentro de sete dias. Portanto, antes de transferir sua aplicação para a instância de destino, encerre ou libere a tarefa, ou use 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 evita que os dados de origem sobrescrevam os dados na instância de destino após a restauração automática da tarefa. 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 Modify instance parameters.
Outras precauções	O DTS atualiza periodicamente a tabela `dts_health_check`.`ha_health_check` no banco de dados de origem para avançar a posição do binlog.

Faturamento

Tipo de migração	Taxas de configuração de link	Taxas de transferência de dados
Migração de esquema + migração completa de dados	Grátis	Grátis (a menos que o método de acesso ao destino seja Public IP Address — veja Billing overview)
Migração incremental de dados	Cobrado — veja Billing overview	—

Tipos de migração

Migração de esquema

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

O DTS migra todos os dados históricos dos objetos de migração especificados do banco de dados de origem para o banco de dados de destino.
Migração incremental

Após a conclusão da migração completa, o DTS migra as 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 sem problemas, sem interromper suas aplicações autogerenciadas.

Operações SQL suportadas para migração incremental

Tipo de operação	Instrução SQL
DML	INSERT, UPDATE e DELETE Nota Quando os dados são gravados em uma instância de destino AnalyticDB for PostgreSQL, o sistema converte automaticamente instruções UPDATE em instruções REPLACE INTO. Se uma instrução UPDATE modificar uma chave primária, o sistema a converterá em uma instrução DELETE seguida por uma instrução INSERT.
DDL	ADD COLUMN

Requisitos de permissão para contas de banco de dados

Banco de dados	Migração de esquema	Migração completa	Migração incremental
Instância PolarDB-X 2.0	Permissão SELECT	Permissão SELECT	Permissões REPLICATION SLAVE, REPLICATION CLIENT e SELECT nos objetos a serem migrados. Nota Para saber como conceder permissões a uma conta de banco de dados, consulte Data synchronization tools for PolarDB-X.
AnalyticDB for PostgreSQL	Permissões de leitura e gravação

Mapeamentos de tipos de dados

Para mais informações, consulte Data type mappings for initial schema synchronization.

Procedimento

Acesse a página da lista de tarefas de migração da região de destino usando um dos 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 Migration.
3. No canto superior esquerdo da página, selecione a região onde a instância de migração está localizada.
Pelo console do DMS

Nota
As operações reais podem variar com base no modo e no layout do console do DMS. Para mais informações, consulte Simple mode 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 a instância de migração está localizada.
Clique em Create Task para acessar a página de configuração da tarefa.

Configure os bancos de dados de origem e de destino.

Aviso

Após selecionar as instâncias de origem e de destino, revise os Limits exibidos na parte superior da página para garantir que a tarefa de migração possa ser criada e executada com sucesso.

Seção	Parâmetro	Descrição
N/A	Task Name	O DTS gera automaticamente um nome para a tarefa. Especifique 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 foi added to the system (criada ou salva), selecione a instância desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente. Nota No console do DMS, este parâmetro é denominado Select a DMS database instance.. Se você não registrou a instância de banco de dados no sistema ou não precisa usar uma instância registrada, configure manualmente as informações do banco de dados abaixo.
	Database Type	Selecione PolarDB-X 2.0.
	Access Method	Selecione Alibaba Cloud Instance.
	Instance Region	Selecione a região onde reside a instância PolarDB-X 2.0 de origem.
	Replicate Data Across Alibaba Cloud Accounts	Este exemplo migra dados dentro da mesma conta Alibaba Cloud. Selecione No.
	Instance ID	Selecione o ID da instância PolarDB-X 2.0 de origem.
	Database Account	Insira a conta do banco de dados da instância PolarDB-X 2.0 de origem. Para mais 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.
Destination Database	Select Existing Connection	Para usar uma instância de banco de dados que foi added to the system (criada ou salva), selecione a instância desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente. Nota No console do DMS, este parâmetro é denominado Select a DMS database instance.. Se você não registrou a instância de banco de dados no sistema ou não precisa usar uma instância registrada, configure manualmente as informações do banco de dados abaixo.
	Database Type	Selecione AnalyticDB for PostgreSQL.
	Access Method	Selecione Alibaba Cloud Instance.
	Instance Region	Selecione a região onde reside a instância AnalyticDB for PostgreSQL de destino.
	Instance ID	Selecione o ID da instância AnalyticDB for PostgreSQL de destino.
	Database Name	Insira o nome do banco de dados de destino na instância AnalyticDB for PostgreSQL.
	Database Account	Insira a conta do banco de dados da instância AnalyticDB for PostgreSQL de destino.
	Database Password	Insira a senha da conta do banco de dados.

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

Nota
Certifique-se de que os segmentos de endereço ip do service DTS foram 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 DTS. Para mais informações, consulte Add DTS server IP addresses to a whitelist.

Configure os objetos da tarefa.

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

Parâmetro	Descrição
Migration Types	Para realizar apenas uma migração completa de dados, selecione tanto Schema Migration quanto Full Data Migration. Para realizar uma migração online sem tempo de inatividade, selecione Schema Migration, Full Data Migration e Incremental Data Migration. Nota Se você selecionar Schema Migration, as chaves estrangeiras no banco de dados de origem também serão migradas para o banco de dados de destino. Se você selecionar Full Data Migration, os esquemas e dados das tabelas criadas usando a instrução CREATE TABLE poderão ser migrados para o banco de dados de destino. Se você 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.
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 é aprovada. Se existirem tabelas com os mesmos nomes, 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 facilmente excluída ou renomeada, você poderá alterar 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 riscos ao negócio. Por exemplo: Se os esquemas 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 esquemas das tabelas forem inconsistentes, apenas algumas colunas de dados poderão ser migradas ou a migração poderá falhar. Prossiga com cautela.
Storage Engine Type	Selecione um mecanismo de armazenamento para as tabelas de destino com base nos requisitos do seu negócio. O valor padrão é Beam. Nota Este parâmetro está disponível apenas se a instância AnalyticDB for PostgreSQL de destino tiver uma versão de kernel v7.0.6.6 ou posterior e você tiver selecionado Migration Types para o parâmetro Schema Migration.
Capitalization of Object Names in Destination Instance	Configure a política de uso de maiúsculas e minúsculas para nomes de bancos de dados, tabelas e colunas migrados na instância de destino. A política padrão do DTS é selecionada por padrão. Você também pode manter a consistência com a política do banco de dados de origem ou de destino. Para mais informações, consulte Capitalization of object names in the destination instance.
Source Objects	Selecione um ou mais objetos na seção Source Objects. Clique no ícone e adicione os objetos à seção Selected Objects. Nota Você pode selecionar apenas tabelas como objetos de migração. Outros objetos, como visualizações, gatilhos e procedimentos armazenados, não são migrados para o banco de dados de destino.
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 recurso de mapeamento de nomes de objetos, a migração de outros objetos que dependem do objeto renomeado poderá falhar. Para especificar uma cláusula WHERE para filtrar dados, clique com o botão direito do mouse em uma tabela na caixa Selected Objects e especifique a condição de filtro na caixa de diálogo exibida. Para mais informações, consulte Filter task data by using SQL statements. Para selecionar as operações SQL a serem migradas no nível da tabela, clique com o botão direito do mouse em uma tabela na caixa Selected Objects e selecione as operações SQL desejadas na caixa de diálogo exibida.

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 iniciará imediatamente uma nova tentativa de conexão. A duração padrão de nova tentativa é de 720 minutos. Você pode personalizar 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 DTS que compartilham a mesma origem ou destino, o tempo de nova tentativa de rede é determinado pela configuração da última tarefa criada. Como você é cobrado 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 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 iniciará imediatamente uma nova tentativa da operação. A duração padrão de nova tentativa é de 10 minutos. Você pode personalizar 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 throttling 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, você também pode optar por definir 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 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 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	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	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 alert notifications. Se uma migração falhar ou a latência exceder o limiar, o sistema enviará uma notificação de alerta.

Opcional: Após concluir as configurações anteriores, clique em Next: Configure Database and Table Fields para configurar a coluna de chave primária e a chave de distribuição das tabelas a serem migradas para a instância AnalyticDB for PostgreSQL de destino.
Nota
- Se você selecionar Migration Types em Schema Migration, deverá configurar parâmetros como Type, Primary Key Column e Distribution Key para as tabelas a serem migradas para a instância AnalyticDB for PostgreSQL. Para mais informações, consulte CREATE TABLE.
- A Primary Key Column pode ser uma chave primária composta por várias colunas, e você deve selecionar uma ou mais colunas da Primary Key Column para servir como Distribution Key.

Salve a tarefa e execute uma pré-verificação.
- Para visualizar 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 no balão que aparece.
- 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 conforme a mensagem exibida 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 conforme a mensagem exibida 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. Se você optar por ignorar um aviso, isso poderá causar problemas como inconsistência de dados e representar riscos ao seu negócio.

Adquira a instância.

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

Na página Purchase, selecione a especificação de 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 é default resource group. Para mais informações, consulte What is Resource Management?
New Instance Class	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.

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 que aparece, 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á parada automaticamente após a conclusão da migração completa. Após a parada da tarefa, seu Status muda para Completed.
- Se a tarefa de migração incluir migração incremental, ela não será parada 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.