O ApsaraDB for ClickHouse é um banco de dados colunar criado para processamento analítico online (OLAP). Ele oferece análises agregadas e consultas rápidas em tabelas largas, com velocidade ordens de magnitude superior à de outros bancos de dados analíticos. Use o Data Transmission service (DTS) para sincronizar dados de um banco de dados MySQL, como um banco de dados MySQL autogerenciado ou uma instância ApsaraDB RDS for MySQL, para um cluster ApsaraDB for ClickHouse. Isso ajuda a centralizar dados para análise. Este tópico usa uma instância RDS MySQL como exemplo para demonstrar como sincronizar seus dados para um cluster ApsaraDB for ClickHouse.
Pré-requisitos
crie um cluster ApsaraDB for ClickHouse de destino com a versão 20.8 ou posterior. Para mais informações, consulte Create a cluster.
O espaço de armazenamento do cluster ApsaraDB for ClickHouse deve ser maior que o espaço utilizado pela instância RDS MySQL de origem.
Limitações
Tipo | Descrição |
Limitações do banco de dados de origem |
|
Outras limitações |
|
Outras observações |
|
Faturamento
|
Tipo de sincronização |
Preço |
|
Sincronização de esquema e sincronização completa de dados |
Gratuito. |
|
Sincronização incremental de dados |
Cobrado. Para mais informações, consulte Billing overview. |
Operações SQL suportadas
Tipo de operação | Instrução SQL |
DML | INSERT, UPDATE, DELETE |
DDL |
|
Mapeamentos de tipos de dados
Como o MySQL e o ApsaraDB for ClickHouse suportam tipos de dados diferentes, não é possível fazer um mapeamento um para um. Durante a sincronização inicial de esquema, o DTS mapeia os tipos de dados com base nos tipos suportados pelo banco de dados de destino. Para mais informações, consulte Data type mappings for initial schema synchronization.
Permissões de conta do banco de dados
Banco de dados | Permissões necessárias | Método de criação e autorização |
RDS MySQL de origem | Permissões de leitura nos objetos a serem sincronizados. | |
Cluster ApsaraDB for ClickHouse de destino |
|
Se a conta do banco de dados de origem em uso não foi criada e autorizada pelo console do RDS MySQL, certifique-se de que ela tenha as permissões REPLICATION CLIENT, REPLICATION SLAVE, SHOW VIEW e SELECT.
Procedimento
-
Acesse a página da lista de tarefas de sincronização da região de destino. Use um dos seguintes métodos:
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 está localizada a instância de sincronização.
Pelo 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 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 da instância de sincronização.
Clique em Create Task para abrir a página de configuração da tarefa.
-
Configure os bancos de dados de origem e de destino.
Categoria
Configuração
Descrição
Nenhuma
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 added to the system (recém-criada ou salva), selecione-a na lista suspensa. As informações do banco de dados são configuradas automaticamente.
NotaNo console do DMS, este item de configuração chama-se Select a DMS database instance..
-
Se não adicionou a instância ao sistema ou não precisa usar uma instância já adicionada, configure manualmente as seguintes informações do banco de dados.
Database Type
Selecione MySQL.
Access Method
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região onde reside a instância RDS MySQL de origem.
Replicate Data Across Alibaba Cloud Accounts
Este exemplo demonstra a sincronização na mesma conta Alibaba Cloud. Selecione No.
RDS Instance ID
Selecione o ID da instância RDS MySQL de origem.
Database Account
insira a conta do banco de dados da instância RDS MySQL de origem. Para informações sobre os requisitos de permissão, consulte Database account permissions.
Database Password
insira a senha correspondente à conta do banco de dados.
Encryption
Selecione Non-encrypted ou SSL-encrypted conforme necessário. Se selecionar SSL-encrypted, ative a criptografia SSL para a instância RDS for MySQL com antecedência. Para mais informações, consulte Use a cloud certificate to quickly enable SSL encryption.
Destination Database
Select Existing Connection
-
Para usar uma instância de banco de dados added to the system (recém-criada ou salva), selecione-a na lista suspensa. As informações do banco de dados são configuradas automaticamente.
NotaNo console do DMS, este item de configuração chama-se Select a DMS database instance..
-
Se não adicionou a instância ao sistema ou não precisa usar uma instância já adicionada, configure manualmente as seguintes informações do banco de dados.
Database Type
Selecione ClickHouse.
Access Method
Selecione Alibaba Cloud Instance.
Instance Region
Selecione a região onde reside o cluster ApsaraDB for ClickHouse de destino.
Replicate Data Across Alibaba Cloud Accounts
Este exemplo demonstra a sincronização na mesma conta Alibaba Cloud. Selecione No.
Cluster Type
Selecione o tipo do cluster ApsaraDB for ClickHouse conforme necessário.
Cluster ID
Selecione o ID do cluster ApsaraDB for ClickHouse de destino.
Database Account
insira a conta do banco de dados do cluster ApsaraDB for ClickHouse de destino. Para informações sobre os requisitos de permissão, consulte Database account permissions.
Database Password
insira a senha correspondente à conta do banco de dados.
-
-
Após concluir a configuração, clique em Test Connectivity and Proceed na parte inferior da página.
NotaCertifique-se de adicionar os blocos CIDR de endereços IP dos servidores do DTS às configurações de segurança dos bancos de dados de origem e de destino para permitir o acesso. Isso pode ser feito automática ou manualmente. 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 autogerenciado (onde o Access Method não é Alibaba Cloud Instance), clique também 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.
Configuração
Descrição
Synchronization Types
A opção Incremental Data Synchronization está 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 dos dados dos objetos selecionados da instância de origem para o cluster de destino. Isso serve como linha de base para a subsequente sincronização incremental.
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. Se existir, a pré-verificação falha e a tarefa de sincronização não inicia.
NotaSe não for possível excluir ou renomear a tabela homônima no banco de dados de destino, mapeie-a para um nome diferente. Para mais informações, consulte Map table and column names.
-
Ignore Errors and Proceed: Ignora a verificação de nomes de tabelas duplicados no banco de dados de destino.
AvisoSelecionar Ignore Errors and Proceed pode causar inconsistência de dados e colocar o seu negócio 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 de um registro no banco de dados de origem:
-
Durante a sincronização completa, o DTS mantém o registro no cluster de destino e não sincroniza o registro correspondente do banco de dados de origem.
-
Durante a sincronização incremental, o registro do banco de dados de origem sobrescreve o registro no banco de dados de destino.
-
-
Se os esquemas das tabelas forem diferentes, a sincronização inicial de dados pode falhar, resultando na sincronização apenas parcial de colunas ou em uma falha completa. Prossiga com cautela.
-
Capitalization of Object Names in Destination Instance
Configure a política de distinção entre 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 está selecionada. Também é possível usar as políticas padrão dos bancos de dados de origem 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 objetos para sincronizar no nível do banco de dados ou da tabela.
Selected Objects
-
Para renomear um único objeto de sincronização na instância de destino, clique com o botão direito no objeto na 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.
NotaPara filtrar dados, clique com o botão direito na tabela a ser sincronizada na caixa Selected Objects e defina as condições de filtro na caixa de diálogo. Para mais informações, consulte Set filter conditions.
Se usar o recurso de mapeamento de nomes de objetos, outros objetos dependentes do objeto mapeado podem falhar na sincronização.
-
-
Clique em Next: Advanced Settings para configurar os parâmetros avançados.
Configuração
Descrição
Dedicated Cluster for Task Scheduling
Por padrão, o DTS agenda tarefas em um cluster compartilhado, e não é necessário selecionar um cluster. Para 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?.
Time zone of destination database
Selecione o fuso horário para os dados DateTime gravados no cluster ApsaraDB for ClickHouse.
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 relata um erro e começa imediatamente a tentar reconectar. A duração padrão de nova tentativa é de 720 minutos. especifique uma duração personalizada de 10 a 1.440 minutos. Recomendamos definir a duração para 30 minutos ou mais. Se o DTS reconectar com sucesso ao banco de dados dentro da duração especificada, a tarefa de sincronização será retomada automaticamente. Caso contrário, a tarefa falha.
Nota-
Se houver várias instâncias do DTS (por exemplo, Instância A e Instância B) compartilhando a mesma origem ou destino, e o tempo de nova tentativa de rede for definido como 30 minutos para a Instância A e 60 minutos para a Instância B, a duração mais curta (30 minutos) será usada para ambas.
-
Como o DTS cobra pelo tempo de execução da tarefa durante o período de nova tentativa de conexão, personalize a duração da 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 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 DDL ou DML), o DTS relata um erro e inicia imediatamente operações contínuas de nova tentativa. A duração padrão é de 10 minutos. Personalize a duração da nova tentativa dentro do intervalo de 1 a 1.440 minutos. Recomendamos definir 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 para Retry Time for Other Issues deve ser menor que o valor para 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 essa carga, 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.
-
Também é possível adjust the full synchronization rate após a instância de sincronização estar em execução.
Enable Throttling for Incremental Data Synchronization
Defina um limite de taxa para a tarefa de sincronização incremental. Para aliviar a pressão no banco de dados de destino, configure RPS of Incremental Data Synchronization e Data synchronization speed for incremental synchronization (MB/s).
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 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 conforme necessário. Nenhuma seleção é necessária para este exemplo.
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, uma notificação é enviada para um contato de alerta.
-
No: Nenhum alerta é configurado.
-
Yes: Configure alertas definindo um limiar de alerta e especificando um notificação de alerta. Para mais informações, consulte Configure monitoring and alerting during task configuration.
-
-
Clique em Next: Configure Database and Table Fields para configurar o Type, Primary Key Column, Sort Key, Distribution Key e Partition Key para as tabelas a serem sincronizadas com o ClickHouse.
O DTS fornece uma configuração padrão. Defina Definition Status como All para modifique a configuração.
-
A Primary Key Column e a Sort Key podem ser chaves compostas. Selecione vários campos nas listas suspensas para definir a Primary Key Column ou a Sort Key. Selecione também uma ou mais colunas da Primary Key Column como a Partition Key. Apenas um campo pode ser selecionado como a Distribution Key. Para mais informações sobre colunas de chave primária, chaves de classificação e chaves de partição, consulte CREATE TABLE.
NotaA Partition Key é opcional, mas não pode ser um campo anulável; caso contrário, a tarefa de sincronização falha.
Há suporte apenas para campos dos tipos BIGINT, INT, TIMESTAMP, DATETIME e DATE como chaves de partição. Para informações sobre a lógica de cálculo, consulte Calculation logic for partition keys.
-
-
salve a tarefa e execute uma pré-verificação.
Para visualize 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 do início do trabalho de sincronização, o DTS executa uma pré-verificação. O trabalho só inicia após a aprovação de todos os itens.
Se a pré-verificação falhar, clique em View Details para o 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 pular o aviso e executar a pré-verificação novamente. Optar por ocultar o item de aviso 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 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
Billing Method
-
Assinatura: Você paga ao criar a instância. 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: Cobrança por hora. Adequado para necessidades de curto prazo. Libere a instância imediatamente após o uso para economizar custos.
Resource Group Configuration
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?.
Link Specification
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 cenário do seu negócio. Para mais informações, consulte Data synchronization link specifications.
Subscription Duration
No modo de assinatura, selecione a duração e a quantidade para a instância. 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.
Apêndice
Informações de tempo
|
Tipo de dado |
Valor mínimo |
Valor máximo |
|
Date |
1970-01-01 00:00:00 |
2149-06-06 00:00:00 |
|
Date32 |
1925-01-01 00:00:00 |
2283-11-11 00:00:00 |
|
DateTime |
1970-01-01 08:00:00 |
2106-02-07 14:28:15 |
|
DateTime64 |
1925-01-01 08:00:00 |
2283-11-12 07:59:59 |
Informações de tabelas e campos
Informações da tabela
Se não usar o recurso de mapeamento de nomes de objetos, as tabelas criadas devem atender aos seguintes requisitos.
Se a tabela de destino incluir um ENGINE, ele deve ser ENGINE = ReplicatedReplacingMergeTree(_version, _is_deleted). Caso contrário, pode ocorrer inconsistência de dados.
Instância ClickHouse Community Edition: Crie uma tabela local e uma tabela distribuída. O nome da tabela distribuída deve ser igual ao nome da tabela de origem. O nome da tabela local deve ser <distributed_table_name>_local.
Instância ClickHouse Enterprise Edition: Crie uma tabela com o mesmo nome da tabela de origem.
Informações do campo
Em uma instância ClickHouse, execute a instrução select * from table_name final where _sign>0; para consultar dados. A condição where filtra os dados excluídos, e a palavra-chave final após o nome da tabela filtra os dados com a mesma chave de classificação.
Versão | Nome | Tipo de dado | Valor padrão | Descrição |
Community Edition anterior à 23.8 | _sign | Int8 | 1 | O tipo de operação DML.
|
_version | UInt64 | 1 | O carimbo de data/hora em que os dados foram gravados no ClickHouse. | |
Enterprise Edition e Community Edition 23.8 e posteriores | _sign | Int8 | 1 | O tipo de operação DML.
|
_is_deleted | UInt8 | 0 | Indica se o registro foi excluído:
| |
_version | UInt64 | 1 | O carimbo de data/hora em que os dados foram gravados no ClickHouse. |
Lógica de cálculo para chaves de partição
Tipo de campo de origem | Lógica de cálculo da chave de partição |
BIGINT |
|
INT |
|
TIMESTAMP |
|
DATETIME | |
DATE |