Você pode usar o DTS para migrar dados de uma instância PolarDB-X para uma instância Elasticsearch.
Pré-requisitos
Uma instância PolarDB-X 2.0 de origem foi criada.
Uma instância Elasticsearch de destino foi criada. Para mais informações, consulte Crie uma instância do Alibaba Cloud Elasticsearch.
Para verificar as versões compatíveis das instâncias de origem e de destino, consulte Overview of migration solutions.
A instância Elasticsearch de destino deve ter mais espaço de armazenamento do que a instância PolarDB-X 2.0 de origem.
Limitações
O DTS migra chaves estrangeiras durante a migração de esquema.
Durante a migração de dados completa e incremental, o DTS desativa temporariamente as verificações de restrição e cascatas de chave estrangeira no nível da sessão. Atualizações ou exclusões em cascata no banco de dados de origem enquanto a tarefa está em execução podem causar inconsistência de dados.
O DTS não oferece suporte à realização de migração completa em várias etapas; a migração completa deve ser concluída em uma única operação. Se você precisar migrar dados em lotes, configure várias tarefas de migração.
|
Tipo |
Descrição |
|
Limitações do banco de dados de origem |
|
|
Outros limites |
|
|
Outras precauções |
O DTS atualiza periodicamente a tabela |
Se um objeto de sincronização do DTS for um alias de índice na instância Elasticsearch de destino, pode ocorrer inconsistência de dados quando o índice real para o qual o alias aponta for alterado. Por exemplo, quando os dados são gravados, o alias de índice aponta para o Índice A. Se o alias posteriormente apontar para o Índice B durante uma operação de exclusão síncrona subsequente, os dados no Índice A não poderão ser excluídos. Como resultado, os dados excluídos da origem ainda podem ser consultados no destino.
Faturamento
|
Tipo de migração |
Taxa de configuração da instância |
Taxa de tráfego de internet |
|
Migração de esquema e migração completa de dados |
Gratuito. |
Quando o parâmetro Access Method do banco de dados de destino é definido como Public IP Address, você é cobrado pelo tráfego de internet. Para mais informações, consulte Billing overview. |
|
Migração incremental de dados |
Cobrado. Para mais informações, consulte 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 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 que você migre dados de forma tranquila, sem interromper suas aplicações autogerenciadas.
Operações SQL para migração incremental
Tipo | Instrução SQL |
DML | INSERT, UPDATE e DELETE Nota O uso de uma instrução UPDATE para remover uma coluna não é uma operação compatível. |
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 de origem |
Permissão |
Permissão |
Permissões Nota Para obter informações sobre como conceder permissões, consulte Account permission issues during data synchronization. |
|
Instância Elasticsearch de destino |
A conta do banco de dados deve ter permissões de leitura e gravação. Normalmente, esta é a conta |
||
Mapeamento de tipos de dados
-
Um banco de dados de origem e uma instância Elasticsearch oferecem suporte a diferentes tipos de dados que nem sempre podem ser mapeados diretamente. Durante a inicialização da estrutura, o DTS mapeia os tipos de dados com base naqueles compatíveis com a instância Elasticsearch de destino. Para mais informações, consulte Data type mapping for structure initialization.
NotaDurante o processo de migração de esquema do DTS, o DTS não define o parâmetro
dynamicemmapping. O comportamento desse parâmetro depende das configurações da sua instância Elasticsearch. Se seus dados de origem forem do tipo JSON, você deve garantir que, para uma chave específica, seus valores correspondentes tenham o mesmo tipo de dados em todas as linhas de uma tabela. Caso contrário, o DTS poderá encontrar problemas de sincronização. Para mais informações, consulte dynamic. -
O mapeamento entre o Elasticsearch e um banco de dados relacional varia de acordo com a versão do Elasticsearch.
ImportanteA partir do Elasticsearch 7.0, um índice não oferece mais suporte a vários tipos, e os tipos foram completamente removidos no Elasticsearch 8.0. Por padrão, ao configurar uma tarefa de sincronização ou migração, o DTS mapeia uma tabela de um banco de dados relacional para um índice no Elasticsearch. Você pode alterar esse mapeamento ao configurar os objetos a serem sincronizados ou migrados.
Elasticsearch 7.0 e posterior
Elasticsearch
Banco de dados relacional
index
table
document
row
field
column
mapping
schema
Versões anteriores ao Elasticsearch 7.0
Elasticsearch
Banco de dados relacional
index
database
type
table
document
row
field
column
mapping
schema
Procedimento
-
Acesse a página da lista de tarefas de migração para a região de destino usando um dos seguintes métodos.
Do console do DTS
Faça login no console do Data Transmission Service (DTS).
No painel de navegação à esquerda, clique em Data Migration.
No canto superior esquerdo da página, selecione a região onde a instância de migração está localizada.
Do console do DMS
NotaAs 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.
Faça login no console do Data Management (DMS).
Na barra de menu superior, escolha .
À 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.
AvisoApós selecionar as instâncias de origem e de destino, recomendamos que você leia atentamente os limites exibidos na parte superior da página. Caso contrário, a tarefa poderá falhar ou ocorrer inconsistência de dados.
Seção
Parâmetro
Descrição
N/D
Task Name
O DTS gera automaticamente um nome de tarefa. Recomendamos que você especifique um nome descritivo para fácil identificação. O nome não precisa ser exclusivo.
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 de banco de dados desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente.
NotaNo console do DMS, este parâmetro é nomeado Select a DMS database instance..
Se você não registrou a instância do 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 a instância PolarDB-X 2.0 de origem está localizada.
Replicate Data Across Alibaba Cloud Accounts
Este exemplo mostra uma migração 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 obter informações sobre as permissões necessárias, consulte Database account permissions.
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 de banco de dados desejada na lista suspensa. As informações do banco de dados abaixo serão configuradas automaticamente.
NotaNo console do DMS, este parâmetro é nomeado Select a DMS database instance..
Se você não registrou a instância do 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 Elasticsearch.
Access Method
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região onde a instância Elasticsearch de destino está localizada.
Type
Selecione Cluster Edition ou Serverless de acordo com suas necessidades.
Instance ID
Selecione o ID da instância Elasticsearch de destino.
Database Account
Insira a conta do banco de dados da instância Elasticsearch de destino. A conta padrão é elastic. Para obter informações sobre as permissões necessárias, consulte Database account permissions.
Database Password
Insira a senha da conta do banco de dados.
Encryption
Selecione HTTP ou HTTPS conforme necessário.
-
Após concluir a configuração, clique em Test Connectivity and Proceed na parte inferior da página.
NotaCertifique-se de que o segmento de endereço IP do serviço DTS seja adicionado 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.
Se o banco de dados de origem ou de destino for um banco de dados autogerenciado (o Access Method não é Alibaba Cloud Instance), você também deve clicar em Test Connectivity na caixa de diálogo CIDR Blocks of DTS Servers que aparece.
-
Configure os objetos da tarefa.
-
Na página Configure Objects, configure os objetos que você deseja migrar.
Parâmetro
Descrição
Migration Types
Se você precisar executar apenas uma migração completa, selecione Schema Migration e Full Data Migration.
Para realizar uma migração sem tempo de inatividade, selecione Schema Migration, Full Data Migration e Incremental Data Migration.
NotaSe você não selecionar Schema Migration, deverá garantir que exista 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 nome de objeto na caixa Selected Objects conforme necessário.
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.
Index Name
-
Table Name
Se você selecionar Table Name, o nome do índice criado na instância Elasticsearch de destino será o mesmo que o nome da tabela. Neste exemplo, o nome do índice é
order. -
Database Name_Table Name
Se você selecionar Database Name_Table Name, o nome do índice criado na instância Elasticsearch de destino estará no formato
Database name_Table name. Neste exemplo, o nome do índice édtstest_order.
Processing Mode of Conflicting 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 é relatado durante a pré-verificação e a tarefa de migração de dados não é iniciada.
NotaSe 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.
AvisoSelecionar Ignore Errors and Proceed pode causar inconsistência de dados e riscos aos negócios. Por exemplo:
Se os esquemas de tabela 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 de tabela forem inconsistentes, apenas algumas colunas de dados poderão ser migradas, ou a migração poderá falhar. Prossiga com cautela.
Capitalization of Object Names in Destination Instance
Você pode configurar a política de diferenciação de maiúsculas e minúsculas para os nomes de bancos de dados, tabelas e colunas na instância de destino. Por padrão, DTS default policy está selecionado. Você também pode selecionar uma política que seja consistente com o banco de dados de origem ou de destino. Para mais informações, consulte Case sensitivity of object names in destination databases.
Source Objects
Selecione um ou mais objetos na seção Source Objects. Clique no ícone
e adicione os objetos à seção Selected Objects. NotaA granularidade para selecionar objetos de migração é esquema, tabela e coluna. Se você selecionar apenas tabelas ou colunas como objetos de migração, outros objetos, como exibições, gatilhos e procedimentos armazenados, não serã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-
O sublinhado (_) é o único caractere especial compatível em nomes de índice e tipo.
-
Se você usar o recurso de mapeamento de nome de objeto, a migração de outros objetos que dependem do objeto renomeado poderá falhar.
-
Para definir uma condição WHERE para filtrar dados, clique com o botão direito do mouse na tabela que deseja migrar na seção Selected Objects e defina a condição de filtro na caixa de diálogo que aparece. Para mais informações, consulte Filter task data by using SQL conditions.
-
Para selecionar as operações SQL a serem migradas no nível do banco de dados ou da tabela, clique com o botão direito do mouse em um objeto na caixa Selected Objects e selecione as operações SQL desejadas na caixa de diálogo que aparece.
-
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. Você não precisa selecionar um. Se desejar tarefas mais estáveis, poderá adquirir 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 de nova tentativa é de 720 minutos. Você pode personalizar o tempo de nova tentativa para um valor de 10 a 1440 minutos. Recomendamos que você defina 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á.
NotaPara 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 você é cobrado pela tarefa durante o período de nova tentativa de conexão, recomendamos que você personalize o tempo de nova tentativa com base nas necessidades do seu negócio ou libere 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 de não 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 de nova tentativa é de 10 minutos. Você pode personalizar o tempo de nova tentativa para um valor de 1 a 1440 minutos. Recomendamos que você defina 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á.
ImportanteO 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, você pode ativar o limitador para a tarefa de migração completa. Você pode definir 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.
NotaEste 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. Você pode definir RPS of Incremental Data Migration e Data migration speed for incremental migration (MB/s) para reduzir a carga no banco de dados de destino.
NotaEste 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.
Environment Tag
Opcional. Selecione uma tag de ambiente para identificar a instância.
Shard Configuration
Defina o número de shards primários e réplicas para o índice com base na configuração máxima de shards do índice na instância Elasticsearch de destino.
String Index
O método para indexar strings na instância Elasticsearch de destino.
-
analyzed: Analisa as strings antes de indexá-las. Você também deve selecionar um analisador específico. Para mais informações sobre os tipos de analisadores e suas funções, consulte Analyzers.
-
not analyzed: Indexa as strings com seus valores originais sem análise.
-
no: Não indexa as strings.
Time Zone
O fuso horário aplicado quando o DTS migra tipos de dados relacionados ao tempo, como DATETIME e TIMESTAMP, para a instância Elasticsearch de destino.
NotaSe esses tipos de dados relacionados ao tempo não exigirem um fuso horário na instância de destino, você deverá definir o tipo de documento (type) para esses tipos de dados na instância de destino antes da migração.
DOCID
O DOCID assume como padrão a chave primária da tabela. Se a tabela não tiver chave primária, o DOCID será a coluna ID que o Elasticsearch gera automaticamente.
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.
Configure ETL
Escolha se deseja ativar o recurso de extração, transformação e carga (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 um alert notifications. Se uma migração falhar ou a latência exceder o limiar, o sistema enviará uma notificação de alerta.
-
Após concluir as configurações anteriores, clique em Next: Configure Database and Table Fields na parte inferior da página para definir a política
_routinge o valor_idpara as tabelas a serem migradas na instância Elasticsearch de destino.Tipo
Descrição
Set _routing
Definir o _routing pode rotear e armazenar documentos em um shard específico da instância Elasticsearch de destino. Para mais informações, consulte _routing.
Selecione Yes para usar colunas personalizadas para roteamento.
Selecione No para usar o _id para roteamento.
NotaSe a instância Elasticsearch de destino for da versão 7.x, você deverá selecionar No.
Value of _id
Primary key column of the table
Uma chave primária composta é mesclada em uma única coluna.
Business primary key
Se você selecionar Business primary key, também deverá definir a Business primary key column correspondente.
-
-
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, mova o ponteiro sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters na dica que aparece.
Se você não precisar visualizar ou já terminou de visualizar os parâmetros da API, clique em Next: Save Task Settings and Precheck na parte inferior da página.
NotaAntes do início da tarefa de migração, o DTS executa 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, você pode clicar 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 pode causar problemas como inconsistência de dados e representar riscos ao seu negócio.
-
Compre 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 é 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. Você pode selecionar uma especificação com base no seu cenário de negócios. 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.
Você pode acompanhar o progresso da tarefa de migração na página de lista Data Migration Tasks.
NotaSe 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.
Verifique o índice e os dados migrados
Após a tarefa de migração de dados entrar no estado Running, conecte-se ao cluster Elasticsearch usando o Kibana para verificar se o índice e os dados foram migrados conforme o esperado. Para mais informações, consulte Log on to the Kibana console.
Se os resultados da migração não forem os esperados, você poderá excluir o índice e seus dados e reconfigurar a tarefa de migração de dados.