# 使用psql命令迁移TaurusDB for PostgreSQL数据 #### 迁移准备 PostgreSQL支持逻辑备份。您可使用pg_dump逻辑备份功能，导出备份文件，再通过psql导入到TaurusDB for PostgreSQL中，实现将PostgreSQL的数据导入到TaurusDB for PostgreSQL数据库中。 #### 准备工作 1. 准备弹性云服务器访问TaurusDB for PostgreSQL数据库。 通过弹性云服务器连接TaurusDB for PostgreSQL数据库实例，需要创建一台弹性云服务器。 2. 在[1]中的弹性云服务器或可访问TaurusDB for PostgreSQL数据库的设备上，安装PostgreSQL客户端。 ![](https://support.huaweicloud.com/usermanual-taurusdb-pg/public_sys-resources/note_3.0-zh-cn.png) 该弹性云服务器或可访问TaurusDB for PostgreSQL数据库的设备上需要安装和TaurusDB for PostgreSQL数据库服务端相同版本的数据库客户端，PostgreSQL数据库或客户端会自带pg_dump和psql工具。 #### 导出数据 要将已有的PostgreSQL数据库迁移到TaurusDB for PostgreSQL数据库，需要先对它进行导出。 ![](https://support.huaweicloud.com/usermanual-taurusdb-pg/public_sys-resources/notice_3.0-zh-cn.png) - 相应导出工具需要与数据库引擎版本匹配。 - 数据库迁移为离线迁移，您需要停止使用源数据库的应用程序。 - 导出或导入数据时，请谨慎，避免因操作不当导致实例或业务异常。 1. 登录已准备的弹性云服务器，或可访问TaurusDB for PostgreSQL数据库的设备。 2. 使用pg_dump将源数据库导出至SQL文件。 ``` pg_dump--username= --host= --port= --format=plain --file= ``` - DB_USER为数据库用户。 - DB_ADDRESS为数据库地址。 - DB_PORT为数据库端口。 - BACKUP_FILE为要导出的文件名称。 - DB_NAME为要迁移的数据库名称。 根据命令提示输入数据库密码。 ![](https://support.huaweicloud.com/usermanual-taurusdb-pg/public_sys-resources/note_3.0-zh-cn.png) 导出的SQL文件为INSERT语句时可以更容易地编辑和手动修改，但是导入数据的速度可能会比使用COPY语句慢一些，建议根据实际情况选择导出合适的语句格式。 - 若源库和目标库都使用PostgreSQL数据库，建议导出COPY语句（默认），参考[•示例一：导出源数据库至SQL文件（COPY语句...]。 - 若源库或目标库使用了非PostgreSQL数据库，建议导出INSERT语句，参考[•示例二：导出源数据库至SQL文件（INSERT...]。 更多使用，请参见[pg_dump选项说明](https://www.postgresql.org/docs/12/app-pgdump.html)。 示例如下： - 示例一：导出源数据库至SQL文件（COPY语句）。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --file=backup.sql my_db ``` **Password for user root:** - 示例二：导出源数据库至SQL文件（INSERT语句）。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --inserts --file=backup.sql my_db ``` **Password for user root:** - 示例三：导出源数据库中所有表结构至SQL文件。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --schema-only --file=backup.sql my_db ``` **Password for user root:** - 示例四：导出源数据库中所有表数据至SQL文件。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --data-only --file=backup.sql my_db ``` **Password for user root:** 命令执行完会生成"backup.sql"文件，如下： ``` $ ll backup.sql -rw-r-----. 1 rds rds 2714 Sep 21 08:23 backup.sql ``` 3. 使用pg_dump将源数据库中的表导出至SQL文件。 ``` pg_dump --username= --host= --port= --format=plain --file= --table= ``` - DB_USER为数据库用户。 - DB_ADDRESS为数据库地址。 - DB_PORT为数据库端口。 - BACKUP_FILE为要导出的文件名称。 - DB_NAME为要迁移的数据库名称。 - TABLE_NAME为要迁移的数据库中指定表名称。 根据命令提示输入数据库密码。 示例如下： - 示例一：导出源数据库中指定的单表至SQL文件。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --file=backup.sql my_db --table=test ``` **Password for user root:** - 示例二：导出源数据库中指定的多表至SQL文件。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --file=backup.sql my_db --table=test1 --table=test2 ``` **Password for user root:** - 示例三：导出源数据库中以ts_开头的所有表至SQL文件。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --file=backup.sql my_db --table=ts_* ``` **Password for user root:** - 示例四：导出源数据库中除ts_开头之外的所有表至SQL文件。 ``` $ pg_dump --username=root --host=192.168.151.18 --port=5432 --format=plain --file=backup.sql my_db -T=ts_* ``` **Password for user root:** 命令执行完会生成"backup.sql"文件，如下： ``` $ ll backup.sql -rw-r-----. 1 rds rds 2714 Sep 21 08:23 backup.sql ``` #### 导入数据 1. 登录已准备的弹性云服务器，或可访问TaurusDB for PostgreSQL数据库的设备。 2. 确保导入的目标数据库已存在。 如果不存在，执行以下命令创建数据库： ``` # psql --host=--port=--username=root--dbname=postgres-c "create database;" ``` - TaurusDB_ADDRESS为TaurusDB for PostgreSQL实例的IP地址。 - DB_PORT为当前数据库实例的端口。 - DB_NAME为要导入的数据库名称。 3. 将导出的文件导入到TaurusDB for PostgreSQL数据库。 ``` # psql --host= --port=--username=root--dbname=--file=/backup.sql ``` - TaurusDB_ADDRESS为TaurusDB for PostgreSQL数据库实例的IP地址。 - DB_PORT为当前数据库实例的端口。 - DB_NAME为要导入的目标数据库名称，请确保该数据库已存在。 - BACKUP_DIR为"backup.sql"所在目录。 根据命令提示输入TaurusDB for PostgreSQL数据库实例的密码。 示例如下： ``` # psql --host=172.16.66.198 --port=5432 --username=root --dbname=my_db --file=backup.sql ``` **Password for user root:** 4. 查看迁移结果，如下。 **my_db=\> \\l my_db** 示例中，名为my_db的数据库已经被导入了： ``` my_db=> \l my_db List of databases Name | Owner | Encoding | Collate | Ctype | Access privileges ------+-------+----------+-------------+-------------+----------- my_db | root | UTF8 | en_US.UTF-8 | en_US.UTF-8 | (1 row) ```