Data Migration

Export & Import into common data formats

Pros:

• Data can be inserted into any DBMS.

Cons:

• Decoding & encoding of common data formats may be slower / require more CPU
• The data size is usually bigger than ClickHouse® formats.
• Some of the common data formats have limitations.

remote/remoteSecure or cluster/Distributed table

Pros:

• Simple to run.
• It’s possible to change the schema and distribution of data between shards.
• It’s possible to copy only some subset of data.
• Needs only access to ClickHouse TCP port.

Cons:

• Uses CPU / RAM (mostly on the receiver side)

See details of both approaches in:

remote-table-function.md

distributed-table-cluster.md

clickhouse-copier

Pros:

• Possible to do some changes in schema.
• Needs only access to ClickHouse TCP port.
• It’s possible to change the distribution of data between shards.
• Suitable for large clusters: many clickhouse-copier can execute the same task together.

Cons:

• May create an inconsistent result if source cluster data is changing during the process.
• Hard to setup.
• Requires zookeeper.
• Uses CPU / RAM (mostly on the clickhouse-copier and receiver side)

See details in:

altinity-kb-clickhouse-copier

Manual parts moving: freeze / rsync / attach

Pros:

• Low CPU / RAM usage.

Cons:

• Table schema should be the same.
• A lot of manual operations/scripting.

See details in:

rsync.md

clickhouse-backup

Pros:

• Low CPU / RAM usage.
• Suitable to recover both schema & data for all tables at once.

Cons:

• Table schema should be the same.

Just create the backup on server 1, upload it to server 2, and restore the backup.

See https://github.com/Altinity/clickhouse-backup

https://altinity.com/blog/introduction-to-clickhouse-backups-and-clickhouse-backup

Fetch from zookeeper path

Pros:

• Low CPU / RAM usage.

Cons:

• Table schema should be the same.
• Works only when the source and the destination ClickHouse servers share the same zookeeper (without chroot)
• Needs to access zookeeper and ClickHouse replication ports: (interserver_http_port or interserver_https_port)

ALTER TABLE table_name FETCH PARTITION partition_expr FROM 'path-in-zookeeper'

alter table fetch detail

Using the replication protocol by adding a new replica

Just make one more replica in another place.

Pros:

• Simple to setup
• Data is consistent all the time automatically.
• Low CPU and network usage should be tuned.

Cons:

• Needs to reach both zookeeper client (2181) and ClickHouse replication ports: (interserver_http_port or interserver_https_port)
• In case of cluster migration, zookeeper need’s to be migrated too.
• Replication works both ways so new replica should be outside the main cluster.

Check the details in:

Add a replica to a Cluster

See also

Github issues

https://github.com/ClickHouse/ClickHouse/issues/10943 https://github.com/ClickHouse/ClickHouse/issues/20219 https://github.com/ClickHouse/ClickHouse/pull/17871

Other links

https://habr.com/ru/company/avito/blog/500678/