Use Holo Shipper

Updated at:

Holo Shipper is an open-source offline backup and migration tool for the Hologres ecosystem. Use it to migrate table data between Hologres instances, export data to external storage, or restore previously exported data back into a Hologres instance. Holo Shipper supports batch data imports and exports, which simplifies operations and improves migration efficiency. This topic describes how to use Holo Shipper and the requirements your environment must meet before you begin.

Background information

Hologres provides the offline backup tool Holo Shipper for data migration. You can use Holo Shipper to migrate all data or specific table data from one instance or database to another. You can also export data to an intermediate storage medium and then import it into Hologres. Holo Shipper supports batch data imports and exports, which simplifies operations and improves migration efficiency. Holo Shipper is open source. For the source code and full configuration reference, see Holo Shipper on GitHub.

Use cases

Holo Shipper supports the following data migration scenarios:

  • Migrate between instances: Move all tables or specific tables from one Hologres instance or database to another.

  • Export to external storage: Dump table data to an external storage medium for backup or cross-region transfer.

  • Restore from external storage: Import previously exported data back into a Hologres instance.

Prerequisites

Before using Holo Shipper, confirm that your environment meets all of the following requirements:

  • Hologres version: Your Hologres instance must run V1.1 or later. If your instance is on an earlier version, see Common errors during upgrade preparation or join the Hologres DingTalk group to provide feedback. For more information, see Get online support for Hologres.

  • Permissions: You must have Superuser permissions on the Hologres instance. Without Superuser permissions, the system returns a permission error.

  • Network connectivity: Your environment must be able to connect to the source and destination tables and have a Java environment.

Limits

The following constraint applies when using Holo Shipper:

  • Do not write to source tables during migration.