PolarDB-X 1.0支持MySQL官方数据导出工具mysqldump。本文将介绍如何使用mysqldump导入导出PolarDB-X 1.0的数据。

注意事项

  • 关于mysqldump命令的详细说明，请参见MySQL 官方文档。
  • mysqldump适合小数据量（低于1000万）的离线导入导出。如果需要完成更大数据量或者实时的数据迁移任务，请参考阿里云提供的从自建MySQL迁移至 PolarDB-X 。

场景一：从MySQL中导出数据到文本文件

  1. 从MySQL中导出数据到文本文件。
    输入如下命令，从MySQL导出表结构和数据（假设导出文件为dump.sql）。 
    mysqldump -h ip -P port -u user -p password --default-character-set=char-set --net_buffer_length=10240 --no-create-db --skip-add-locks --skip-lock-tables --skip-tz-utc --set-charset  [--hex-blob] [--no-data] database [table1 table2 table3...] > dump.sql
    表 1. 参数说明
    参数名说明是否必选
    ipMySQL的IP。✔️
    portMySQL的端口。❌
    userMySQL的用户名。✔️
    passwordMySQL的密码，注意前面有个 -p，之间没有空格。✔️
    char-set指定的编码。✔️
    --hex-blob使用十六进制格式导出二进制字符串字段。如果有二进制数据就必须使用本选项。影响的字段类型包括 BINARY、VARBINARY、BLOB。❌
    --no-data不导出数据。❌
    table指定导出某个表。默认导出该数据库所有的表。❌
  2. 修改建表语句。

    从MySQL导出的数据文件包含每个表的建表语句。如果直接在PolarDB-X 1.0上执行这些建表语句，会在PolarDB-X 1.0上建立一个单表。如果要对某个表进行分库分表，那么需要手动对建表语句进行修改，PolarDB-X 1.0建表语句的语法请参考CREATE TABLE。

  3. 导入数据文件到PolarDB-X 1.0。您可以通过如下两种方式的任意一种导入数据文件到PolarDB-X 1.0。
    • 通过mysql -h ip -P port -u user --default-character-set=char-set命令登录目标PolarDB-X 1.0，执行source /yourpath/dump.sql命令将数据导入到目标PolarDB-X 1.0。
      说明 该方式会把所有的步骤回显到屏幕上，速度略慢，但是可以观察导入过程。
    • 直接通过mysql -h ip -P port -u user --default-character-set=char-set< /yourpath/dump.sql命令将数据导入到目标PolarDB-X 1.0。
    说明
    • 上述两个命令中default-character-set要设置成实际的数据编码。如果是Windows平台，SOURCE命令指定的文件路径需要对分隔符转义。
    • 导入的时候，由于某些PolarDB-X 1.0和MySQL实现上的不同，可能会报错（如ERROR 1231 (HY000): [a29ef6461c00000][10.117.207.130:3306][****]Variable @saved_cs_client can't be set to the value of @@character_set_client）。此类错误信息并不影响导入数据的正确性。

场景二：从一个PolarDB-X 1.0导入到另一个PolarDB-X 1.0

假设您之前有一个测试环境的PolarDB-X 1.0，测试完毕以后，需要把测试过程中的一些表结构和数据导入到生产环境的PolarDB-X 1.0中，那么可以按照如下步骤进行操作。

  1. 从源PolarDB-X 1.0中导出数据到文本文件。
  2. 导入数据文件到PolarDB-X 1.0。请参考场景一第3步。
  3. 手动创建Sequence对象。
    mysqldump并不会导出PolarDB-X 1.0中的Sequence对象，所以如果在源PolarDB-X 1.0中使用了Sequence对象，并且需要在目标PolarDB-X 1.0中继续使用相同的Sequence对象，则需要手动在目标PolarDB-X 1.0中创建同名的Sequence的对象。具体步骤如下：
    1. 在源PolarDB-X 1.0上执行SHOW SEQUENCES，获取当前PolarDB-X 1.0中的Sequence对象的状态。
    2. 在目标PolarDB-X 1.0数据库上通过CREATE SEQUENCE命令创建新的Sequence对象。

场景三：从PolarDB-X 1.0导出数据到MySQL

从PolarDB-X 1.0导出数据到MySQL，和在PolarDB-X 1.0之间相互导入数据的过程类似，也分为以下几个步骤。

  1. 从源PolarDB-X 1.0中导出表结构和数据。
    mysqldump -h ip -P port -u user -p password --default-character-set=char-set --net_buffer_length=10240 --no-create-db --skip-add-locks --skip-lock-tables --skip-tz-utc --set-charset  [--hex-blob] [--no-data] database [table1 table2 table3...] > dump.sql
    说明 请将PolarDB-X 1.0的相关参数代入命令中执行。
  2. 手动修改拆分表的DDL语句。
    PolarDB-X 1.0中拆分表的建表语句和MySQL并不兼容。为了后续导入到MySQL中，需手动修改导出的SQL文件，删除以下关键字：
    • DBPARTITION BY hash(partition_key):
    • TBPARTITION BY hash(partition_key):
    • TBPARTITIONS N
    • BROADCAST
    例如一个拆分表语句导出如下：
    CREATE TABLE multi_db_single_tbl
(id int, 
name varchar(30), 
primary key(id)) dbpartition by hash(id);
    需修改成以下语句：
    CREATE TABLE multi_db_single_tbl
(id int,
name varchar(30), 
primary key(id));
  3. 导入修改以后的文件。请参见场景一第3步。