Você pode usar o DTS para sincronizar dados de uma instância do PolarDB-X 2.0 para uma instância do Elasticsearch.
Pré-requisitos
Você deve ter uma instância de origem do PolarDB-X 2.0.
Você deve ter um cluster de destino do Elasticsearch. Para mais informações, consulte Create an Alibaba Cloud Elasticsearch instance.
Para ver as versões de origem e destino compatíveis, consulte Synchronization solution overview.
O cluster de destino do Elasticsearch deve ter mais espaço de armazenamento disponível do que o tamanho dos dados da instância de origem do PolarDB-X 2.0.
Limitações
Durante a sincronização de schema, o DTS sincroniza as chaves estrangeiras do banco de dados de origem para o banco de dados de destino.
Durante a sincronização completa e a sincronização incremental de dados, o DTS desativa temporariamente a verificação de restrições e as operações em cascata de chaves estrangeiras no nível da sessão. Se ocorrerem atualizações ou exclusões em cascata no banco de dados de origem durante a sincronização, podem surgir inconsistências de dados.
|
Tipo |
Descrição |
|
Limitações do banco de dados de origem |
|
|
Outras limitações |
|
|
Outras precauções |
O DTS atualiza periodicamente a tabela |
Se os objetos a serem sincronizados pelo DTS forem aliases de índice no Elasticsearch de destino, pode ocorrer inconsistência de dados quando o índice real para o qual um alias de índice aponta for alterado. Por exemplo, o alias de índice aponta para o índice A quando os dados são gravados. No entanto, durante a sincronização subsequente de operações de exclusão, o alias de índice aponta para o índice B. Nesse caso, não é possível excluir os dados no índice A, e os dados que foram excluídos da origem ainda podem ser consultados no destino.
Faturamento
|
Tipo de sincronização |
Preço |
|
Sincronização de schema e sincronização completa de dados |
Gratuito. |
|
Sincronização incremental de dados |
Cobrado. Para mais informações, consulte Billing overview. |
Topologias de sincronização
Sincronização unidirecional um para um
Sincronização unidirecional um para muitos
Sincronização unidirecional muitos para um
Para mais informações, consulte Synchronization topologies.
Operações SQL suportadas
Tipo de operação | Instrução SQL |
DML | INSERT, UPDATE e DELETE Nota A sincronização não suporta a remoção de colunas por meio de instruções UPDATE. |
Mapeamento de tipos de dados
-
Um banco de dados source 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 nos tipos suportados pela instância do Elasticsearch de destino. Para mais informações, consulte Data type mapping for structure initialization.
NotaDurante o processo de migração de schema do DTS, o DTS não defina o parâmetro
dynamicemmapping. O comportamento desse parâmetro depende das configurações da sua instância do Elasticsearch. Se os seus dados source forem do tipo JSON, você deve garantir que, para uma chave específica, os 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 suporta mais vários tipos, e os tipos foram completamente removidos no Elasticsearch 8.0. Por padrão, quando você configure 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 versões posteriores
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 sincronização da região de destino. Use um dos dois 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 Synchronization.
No canto superior esquerdo da página, selecione a região onde a instância de sincronização está localizada.
Pelo console do DMS
NotaAs operações reais podem variar de acordo com o modo e o layout do console do DMS. Para mais informações, consulte Simple mode e Customize the layout and style of the DMS interface.
Faça login no Data Management (DMS).
Na barra de menu superior, escolha .
À direita de Data Synchronization Tasks, selecione a região onde a instância de sincronização está localizada.
Clique em Create Task para abrir 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, leia atentamente os limites exibidos na parte superior da página. Se você não seguir os limites, a tarefa poderá falhar ou poderá ocorrer inconsistência de dados.
Categoria
Parâmetro
Descrição
N/D
Task Name
O DTS gera automaticamente um nome para a tarefa. Recomendamos que você especifique um nome descritivo para facilitar a identificação. O nome não precisa ser único.
Source Database
Database Type
Selecione PolarDB-X 2.0.
Connection Type
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região onde a instância de origem do PolarDB-X 2.0 está localizada.
Replicate Data Across Alibaba Cloud Accounts
Este exemplo usa uma instância de banco de dados que pertence à conta atual do Alibaba Cloud. Selecione No.
Instance ID
Selecione o ID da instância de origem do PolarDB-X 2.0.
Database Account
Insira a conta do banco de dados da instância de origem do PolarDB-X 2.0. A conta deve ter as permissões REPLICATION SLAVE, REPLICATION CLIENT e SELECT nos objetos a serem sincronizados.
NotaPara obter informações sobre como conceder permissões, consulte Account permission issues during data synchronization.
Database Password
Insira a senha correspondente à conta do banco de dados.
Destination Database
Database Type
Selecione Elasticsearch.
Connection Type
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região onde a instância de destino do Elasticsearch está localizada.
Type
Selecione Cluster Edition ou Serverless.
Instance ID
Selecione o ID da instância de destino do Elasticsearch.
Database Account
Insira a conta do banco de dados da instância de destino do Elasticsearch. A conta deve ter permissões de leitura e gravação. A conta padrão é
elastic.Database Password
Insira a senha correspondente à 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 os blocos CIDR de endereços IP dos servidores DTS foram adicionados às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso dos servidores DTS. Isso pode ser feito de forma automática ou manual. Para mais informações, consulte Add the IP address CIDR blocks of DTS servers to a whitelist.
Se o banco de dados de origem ou de destino for um banco de dados autogerenciado (onde 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.
-
Configure os objetos da tarefa.
-
Na página Configure Objects, configure os objetos a serem sincronizados.
Parâmetro
Descrição
Synchronization Types
A opção Incremental Data Synchronization vem selecionada por padrão. Selecione também Schema Synchronization e Full Data Synchronization. Após a conclusão da pré-verificação, o DTS realiza uma sincronização completa de dados dos objetos selecionados da instância source para o cluster de destino. Isso serve como dados de linha de base para a sincronização incremental de dados subsequente.
Index Name
-
Table Name
Selecione Table Name para que o nome do índice na instância Elasticsearch de destino corresponda ao nome da tabela. Por exemplo, o nome do índice será 'order'.
-
Database Name_Table Name
Selecione Database Name_Table Name para que o nome do índice na instância Elasticsearch de destino siga o formato NomeDoBanco_NomeDaTabela. Por exemplo, o nome do índice será dtstest_order.
Processing Mode of Conflicting Tables
-
Precheck and Report Errors: Verifica se existe uma tabela com o mesmo nome no banco de dados de destino. Se não existir, a pré-verificação é aprovada. Caso exista, a pré-verificação falha e a tarefa de sincronização de dados não é iniciada.
NotaExclua ou renomeie a tabela com o mesmo nome no banco de dados de destino. Se isso não for possível, mapeie-a para um nome de tabela diferente. Para mais informações, consulte Map table and column names.
-
Ignore Errors and Proceed: Ignora a verificação de nomes de tabela duplicados no banco de dados de destino.
AvisoA opção Ignore Errors and Proceed pode causar inconsistência de dados e colocar seus negócios em risco. Por exemplo:
-
Se os esquemas das tabelas forem iguais e um registro no banco de dados de destino tiver o mesmo valor de chave primária ou chave única que um registro no banco de dados source:
-
Durante a sincronização completa, o DTS mantém o registro no cluster de destino. O registro correspondente do banco de dados source não é sincronizado.
-
Durante a sincronização incremental, o registro do banco de dados source substitui o registro no banco de dados de destino.
-
-
Se os esquemas das tabelas forem diferentes, a sincronização inicial de dados poderá falhar. Isso pode resultar na sincronização de apenas dados parciais de colunas ou em uma falha completa de sincronização. Prossiga com cautela.
-
Capitalization of Object Names in Destination Instance
Configure a política de diferenciação de maiúsculas e minúsculas para os nomes de objetos de banco de dados, tabelas e colunas sincronizados com a instância de destino. Por padrão, a DTS default policy vem selecionada. Como alternativa, escolha as políticas padrão dos bancos de dados source e de destino. Para mais informações, consulte Case sensitivity policy for destination object names.
Source Objects
Na caixa Source Objects, clique em um objeto a ser sincronizado e, em seguida, clique em
para movê-lo para a caixa Selected Objects.NotaSelecione bancos de dados, tabelas e colunas como objetos de sincronização. Caso a seleção inclua tabelas ou colunas, outros objetos, como visualizações, gatilhos e procedimentos armazenados, não serão sincronizados com o banco de dados de destino.
Selected Objects
-
Para renomear um único objeto de sincronização na instância de destino, clique com o botão direito do mouse no objeto dentro da caixa Selected Objects. Para mais informações sobre como renomear objetos, consulte Map a single database, table, or column.
-
Para alterar em lote os nomes de vários objetos de sincronização na instância de destino, clique em Batch Edit no canto superior direito da caixa Selected Objects. Para mais informações, consulte Map databases, tables, and columns in a batch.
Nota-
O único caractere especial aceito em nomes de índices e tipos é o sublinhado (_).
-
Selecione as operações SQL a serem sincronizadas no nível do banco de dados ou da tabela. Para isso, clique com o botão direito do mouse no objeto na caixa Selected Objects e, em seguida, escolha as operações SQL desejadas.
-
Para filtrar dados usando uma cláusula WHERE, clique com o botão direito do mouse na tabela dentro da caixa Selected Objects e defina a condição de filtro. Para mais informações, consulte Filter task data by using SQL conditions.
-
Se você usar o recurso de mapeamento de nomes de objetos, outros objetos que dependam do objeto mapeado poderão falhar na sincronização.
-
-
Clique em Next: Advanced Settings para configurar os parâmetros avançados.
Parâmetro
Descrição
Dedicated Cluster for Task Scheduling
Por padrão, o DTS agenda tarefas em um cluster compartilhado, e você não precisa selecionar um cluster. Para obter um desempenho mais estável, adquira um cluster dedicado para executar tarefas de sincronização do DTS. Para mais informações, consulte What is a DTS dedicated cluster?.
Retry Time for Failed Connections
Após o início de uma tarefa de sincronização, se a conexão com o banco de dados de origem ou de destino falhar, o DTS reportará um erro e iniciará imediatamente novas tentativas de conexão. A duração padrão de nova tentativa é de 720 minutos. Você também pode especificar uma duração personalizada de 10 a 1.440 minutos. Recomendamos definir a duração como 30 minutos ou mais. Se o DTS conseguir reconectar ao banco de dados dentro do período especificado, a tarefa de sincronização retoma automaticamente. Caso contrário, a tarefa falha.
Nota-
Se você tiver várias instâncias do DTS (por exemplo, Instância A e Instância B) que compartilham a mesma origem ou destino, e definir o tempo de nova tentativa de rede como 30 minutos para a Instância A e 60 minutos para a Instância B, a duração menor, de 30 minutos, prevalecerá para ambas.
-
Como o DTS cobra pelo tempo de execução da tarefa durante o período de nova tentativa de conexão, recomendamos personalizar a duração de nova tentativa com base nas suas necessidades de negócios 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 sincronização, se ocorrerem outros problemas não relacionados à conectividade com o banco de dados de origem ou de destino (como exceções de execução de DDL ou DML), o DTS reportará um erro e iniciará imediatamente operações contínuas de nova tentativa. A duração padrão é de 10 minutos. Você também pode personalizar a duração dentro do intervalo de 1 a 1.440 minutos. Recomendamos definir esse valor como 10 minutos ou mais. Se as operações relevantes forem bem-sucedidas dentro da duração definida, a tarefa de sincronização retoma automaticamente. Caso contrário, a tarefa falha.
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 Synchronization
Durante a fase de sincronização completa, o DTS consome recursos de leitura e gravação dos bancos de dados de origem e de destino, o que pode aumentar a carga do banco de dados. Para reduzir a carga nos bancos de dados de origem e de destino, defina um limite de taxa para a tarefa de sincronização completa configurando os parâmetros Queries per second (QPS) to the source database, RPS of Full Data Migration e Data migration speed for full migration (MB/s).
Nota-
Este item de configuração está disponível apenas quando Synchronization Types está definido como Full Data Synchronization.
-
Você também pode adjust the full synchronization rate após a instância de sincronização estar em execução.
Enable Throttling for Incremental Data Synchronization
Você também pode definir um limite de taxa para a tarefa de sincronização incremental. Para aliviar a pressão sobre o banco de dados de destino, defina RPS of Incremental Data Synchronization e Data synchronization speed for incremental synchronization (MB/s).
Environment Tag
Selecione uma tag de ambiente para identificar a instância. Neste exemplo, nenhuma tag é necessária.
Shard Configuration
Defina o número de shards primários e réplicas com base na configuração máxima de shards da instância Elasticsearch de destino.
String Index
Especifique como as strings são indexadas na instância Elasticsearch de destino.
-
analyzed: o DTS analisa a string e depois a indexa. Você também deve selecionar um analisador. Para mais informações sobre os tipos de analisadores e suas funções, consulte Analyzers.
-
not_analyzed: o DTS indexa a string como está, sem análise.
-
no: o DTS não indexa a string.
Time Zone
Selecione um fuso horário para tipos de dados relacionados a tempo, como DATETIME e TIMESTAMP, ao sincronizar com a instância Elasticsearch de destino.
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
O DOCID tem como padrão a chave primária da tabela. Se a tabela não tiver chave primária, o Elasticsearch gera um ID 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 durante a execução da instância do DTS.
-
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 reporte 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
Especifique se deseja configurar alertas. Se a sincronização falhar ou a latência exceder o limiar especificado, o sistema envia uma notificação ao contato de alerta.
-
No: nenhum alerta é configurado.
-
Yes: configure alertas definindo um limiar de alerta e especificando um alert notification. Para mais informações, consulte Configure monitoring and alerting during task configuration.
-
-
Após concluir a configuração, clique em Next: Configure Database and Table Fields na parte inferior da página para definir a política de _routing e o valor de _id para a tabela a ser sincronizada no Elasticsearch de destino.
Tipo
Descrição
Set _routing
Definir _routing permite rotear e armazenar documentos em um shard específico da instância Elasticsearch de destino. Para obter mais informações, consulte _routing.
-
Se você selecionar Yes, é possível usar colunas personalizadas para roteamento.
-
Se você selecionar No, o _id será utilizado no roteamento.
NotaSe a instância Elasticsearch de destino estiver na versão 7.x, selecione No.
Value of _id
-
Primary key column of the table
Chaves primárias compostas são mescladas em uma única coluna.
-
Business primary key
Se você selecionar Business primary key, defina também a Business primary key column correspondente.
-
-
-
Salve a tarefa e execute uma pré-verificação.
Para visualizar os parâmetros da API para configurar esta instância, passe o mouse sobre o botão Next: Save Task Settings and Precheck e clique em Preview OpenAPI parameters na dica.
Após visualizar os parâmetros da API, clique em Next: Save Task Settings and Precheck na parte inferior da página.
NotaAntes que o trabalho de sincronização seja iniciado, o DTS executa uma pré-verificação. O trabalho só é iniciado após a aprovação de todos os itens da pré-verificação.
Se a pré-verificação falhar, clique em View Details no item com falha. Corrija o problema conforme instruído e execute a pré-verificação novamente.
-
Se a pré-verificação retornar um aviso:
Se um item de verificação falhar e não puder ser ignorado, clique em View Details ao lado do item. Siga as instruções para corrigir o problema e execute a pré-verificação novamente.
Para itens de verificação que podem ser ignorados, clique em Confirm Alert Details, Ignore, OK e Precheck Again em sequência para ignorar o aviso e executar a pré-verificação novamente. Caso escolha ocultar o item de aviso, isso pode causar problemas como inconsistência de dados e apresentar riscos ao seu negócio.
-
Adquira a instância.
Quando a Success Rate for 100%, clique em Next: Purchase Instance.
-
Na página Purchase, selecione o método de faturamento e a especificação do link para a instância de sincronização de dados. A tabela a seguir descreve esses parâmetros em detalhes.
Categoria
Parâmetro
Descrição
New Instance Class
Método de faturamento
-
Assinatura: crie a instância e pague. Este método é adequado para necessidades de longo prazo e é mais econômico que o pagamento conforme o uso. Quanto maior a duração da assinatura, maior o desconto.
-
Pagamento conforme o uso: a cobrança é por hora, sendo ideal para demandas de curto prazo. Libere a instância logo após o uso para reduzir custos.
Configuração do grupo de recursos
O grupo de recursos ao qual a instância pertence. O padrão é o grupo de recursos padrão. Para mais informações, consulte What is Resource Management?.
Especificação do link
O DTS fornece especificações de sincronização com diferentes níveis de desempenho. A especificação do link de sincronização afeta a taxa de sincronização. Escolha uma especificação com base no seu cenário de negócios. Para mais informações, consulte Data synchronization link specifications.
Duração da assinatura
No modo de assinatura, selecione a duração e a quantidade para a instância de assinatura. Escolha uma assinatura mensal de 1 a 9 meses, ou uma assinatura anual de 1, 2, 3 ou 5 anos.
NotaEsta opção está disponível apenas quando o método de faturamento é Subscription.
-
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, clique em OK.
Visualize o progresso da tarefa na página Data Synchronization.
Verifique o índice e os dados sincronizados
Quando a tarefa de sincronização atingir o estado Running, use o Kibana para se conectar ao cluster do Elasticsearch e verifique se o índice e os dados atendem aos seus requisitos. Para obter instruções, consulte Log on to the Kibana console.
Caso o índice ou os dados não atendam aos seus requisitos, exclua o índice e configure novamente a tarefa de sincronização de dados.