Use o Data Transmission Service (DTS) para migrar dados do PolarDB for MySQL para o Elasticsearch.
Pré-requisitos
Crie um cluster de destino no Elasticsearch. Para mais informações, consulte Beginner: Create a cluster and retrieve data.
O espaço de armazenamento do cluster de destino no Elasticsearch deve ser superior ao utilizado pela instância de origem do PolarDB for MySQL.
Limitações
Tipo | Descrição |
Limitações do banco de dados de origem |
|
Outras limitações |
|
Outras observações | O DTS executa periodicamente o comando CREATE DATABASE IF NOT EXISTS |
Se um objeto de sincronização do DTS for um alias de índice na instância de destino do Elasticsearch, pode ocorrer inconsistência de dados quando o índice real apontado pelo alias for alterado. Por exemplo, quando os dados são gravados, o alias do índice aponta para o Índice A. Se o alias passar a 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, dados excluídos da origem ainda poderão 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 estiver definido como Public IP Address, você será cobrado pelo 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 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 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 para migração incremental
Tipo | Instrução SQL |
DML | INSERT, UPDATE e DELETE Nota Não há suporte para o uso de uma instrução UPDATE para remover uma coluna. |
Requisitos de permissão para contas de banco de dados
|
Banco de dados |
Requisitos de permissão |
Criação e autorização |
|
Cluster PolarDB for MySQL |
Permissão de leitura nos objetos a serem migrados |
Mapeamento de tipos de dados
-
Um banco de dados de origem e uma instância do Elasticsearch suportam tipos de dados diferentes que nem sempre podem ser mapeados diretamente. Durante a inicialização da estrutura, o DTS mapeia os tipos de dados com base naqueles suportados pela instância de destino do Elasticsearch. 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
dynamicnomapping. O comportamento desse parâmetro depende das configurações da sua instância do Elasticsearch. Se seus dados de origem forem do tipo JSON, garanta 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 pode encontrar problemas de sincronização. Para mais informações, consulte dynamic. -
O mapeamento entre o Elasticsearch e um banco de dados relacional varia conforme a versão do Elasticsearch.
ImportanteA partir do Elasticsearch 7.0, um índice não suporta mais 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. É possível 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 da região de destino usando um dos métodos a seguir.
Pelo 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.
Pelo console do DMS
NotaAs operações reais podem variar dependendo do modo e do 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.
Seção
Parâmetro
Descrição
N/A
Task Name
O DTS gera automaticamente um nome para a tarefa. Recomendamos especificar um nome descritivo para facilitar a identificação. O nome não precisa ser único.
Source Database
Select Existing Connection
Para usar uma instância de banco de dados que 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.
NotaNo 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 for MySQL.
Access Method
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região do cluster de origem PolarDB for MySQL.
Cross-account
Este exemplo migra dados dentro da mesma conta da Alibaba Cloud. Selecione No.
PolarDB Cluster ID
Selecione o ID do cluster de origem PolarDB for MySQL.
Database Account
Insira a conta do banco de dados do cluster de origem PolarDB for MySQL. Para informações sobre as permissões necessárias, consulte Permissions required for the database account.
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 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.
NotaNo 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 Elasticsearch.
Access Method
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região do cluster de destino do Elasticsearch.
Type
Selecione Cluster ou Serverless de acordo com seus requisitos.
Instance ID
Selecione o ID do cluster de destino do Elasticsearch.
Database Account
Insira a conta do banco de dados para o cluster do Elasticsearch. A conta padrão é elastic.
Database Password
Insira a senha de login definida ao criar o cluster do Elasticsearch.
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 service DTS foi 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), clique também 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 deseja migrar.
Parâmetro
Descrição
Migration Types
Se precisar realizar apenas uma migração completa, selecione tanto Schema Migration quanto Full Data Migration.
Para realizar uma migração sem tempo de inatividade, selecione Schema Migration, Full Data Migration e Incremental Data Migration.
NotaSe não selecionar Schema Migration, garanta que exista um banco de dados e tabelas para receber os dados no banco de dados de destino. Também é possível 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.
Processing Mode for Existing Destination Tables
Precheck and Report Errors: O DTS verifica se há tabelas no banco de dados de destino com os mesmos nomes das da origem. A pré-verificação é aprovada se tais tabelas não existirem. Caso contrário, a pré-verificação falha e a tarefa de migração de dados não é iniciada.
NotaSe não for possível excluir ou renomear as tabelas com os mesmos nomes no banco de dados de destino, altere seus nomes no banco de dados de destino. Para mais informações, consulte object name mapping.
Ignore Errors and Proceed: Ignora a pré-verificação para tabelas com os mesmos nomes.
AvisoSelecionar Ignore Errors and Proceed pode causar inconsistência de dados e risco de interrupção do service. 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 de dados, o DTS mantém o registro no cluster de destino. O registro do banco de dados de origem não é migrado.
Durante a migração incremental de dados, o DTS não mantém o registro no cluster de destino. O registro do banco de dados de origem sobrescreve aquele no banco de dados de destino.
Se os esquemas das tabelas forem inconsistentes, a inicialização de dados pode falhar, apenas dados parciais podem ser migrados ou a migração pode falhar.
Index Name
Table Name
Se selecionar Table Name, o índice criado na instância de destino do Elasticsearch terá o mesmo nome da tabela de origem.
Database Name_Table Name
Se selecionar Database Name_Table Name, o índice criado na instância de destino do Elasticsearch será nomeado no formato NomeDoBancoDeDados_NomeDaTabela.
Case Sensitivity Policy for Destination Object Names
Configure a sensibilidade a maiúsculas e minúsculas para nomes de bancos de dados, tabelas e colunas dos objetos migrados na instância de destino. Por padrão, DTS default policy está selecionado. Você também pode optar por manter o mesmo caso do banco de dados de origem ou de destino. Para mais informações, consulte Case sensitivity of object names in the destination database.
Source Objects
Selecione um ou mais objetos na seção Source Objects. Clique no ícone
e adicione os objetos à seção Selected Objects. NotaÉ possível selecionar bancos de dados ou tabelas como objetos de migração. Se selecionar tabelas, outros objetos como visualizaçõ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 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.
NotaApenas sublinhados (_) são suportados como caracteres especiais em nomes de índices e nomes de tipos.
Para filtrar dados com condições WHERE ou especificar detalhes pós-migração como índice, tipo e nomes de colunas, clique com o botão direito em uma tabela na caixa Selected Objects. Configure as opções na caixa de diálogo exibida. Para mais informações, consulte Configure filter conditions.
Para selecionar operações SQL a serem migradas no nível de banco de dados ou tabela, clique com o botão direito em um objeto de migração na caixa Selected Objects e selecione as operações SQL desejadas na caixa de diálogo exibida. Para informações sobre operações suportadas, consulte SQL operations supported for incremental data migration.
-
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 de nova tentativa é de 720 minutos. É possível 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á.
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 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 não relacionado à conexão, 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. É possível 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á.
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, ative o limitador de taxa 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.
NotaEste item de configuração está disponível apenas se você selecionar Full Data Migration em 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, também é possível 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.
NotaEste item de configuração está disponível apenas se você selecionar Incremental Data Migration em 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
Selecione uma tag de ambiente para identificar a instância conforme suas necessidades. Este parâmetro não é obrigatório para este exemplo.
Shard Configuration
Defina o número de shards primários e de réplica para o índice com base na configuração máxima de shards para um índice no cluster de destino Elasticsearch.
String Index
Especifica como indexar strings migradas para o cluster de destino do Elasticsearch.
analyzed: Analisa as strings antes da indexação. É necessário selecionar também um analisador específico. Para mais informações sobre tipos de analisadores e suas funções, consulte Analyzers.
not analyzed: Indexa as strings diretamente usando seus valores originais, sem análise.
no: Não indexa as strings.
Time Zone
Selecione o fuso horário para tipos de dados relacionados a tempo (como DATETIME e TIMESTAMP) migrados para a instância de destino do Elasticsearch.
NotaSe os tipos de dados relacionados a tempo na instância de destino não exigirem um fuso horário, defina o tipo de documento (type) para esses tipos de dados na instância de destino antes da sincronização.
DOCID
Por padrão, o DOCID é a chave primária da tabela. Se a tabela não tiver chave primária, o DOCID será uma coluna de ID gerada automaticamente pelo Elasticsearch.
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 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
Com base nas necessidades do seu negócio, selecione se deseja configurar o ETL feature para processar dados.
Yes: Configura o recurso ETL. Também é necessário inserir data processing statements na caixa de texto.
No: Não configura 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 notificações de alerta. 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 para definir a política _routing e o valor _id para as tabelas a serem migradas para a instância de destino do Elasticsearch.
Parâmetro
Descrição
Set _routing
O parâmetro _routing roteia um documento para um shard específico na instância de destino do Elasticsearch. Para mais informações, consulte _routing.
Selecione Yes para especificar colunas personalizadas para roteamento.
Selecione No para usar o valor _id para roteamento.
NotaSe a instância de destino do Elasticsearch for da versão 7.x, selecione No.
Value of _id
Primary key column
Uma chave primária composta é mesclada em uma única coluna.
Business key
Se selecionar Business key, também será necessário especificar a business key column.
-
-
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 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.
NotaAntes do início da tarefa de migração, o DTS realiza uma pré-verificação. A tarefa só começa 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 orientaçã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 conforme a orientaçã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. Se optar por ignorar um aviso, isso pode causar problemas como inconsistência de dados e representar riscos para o 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?
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 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.
Visualize 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.