将PostgreSQL迁移到PostgreSQL

• 本地自建PostgreSQL数据库
• ECS自建PostgreSQL数据库
• 其他云上PostgreSQL数据库
• RDS for PostgreSQL

• RDS for PostgreSQL

数据库权限设置

• 全量迁移最小权限要求：
  • 源数据库账号需要具备数据库的CONNECT权限，模式的USAGE权限，表的SELECT权限，序列的SELECT权限，如果需要同步用户，还需要具有CREATEROLE权限。
  • 库级迁移时，目标数据库账户需要具有CREATEDB权限。
  • 表级迁移时，如果数据库不存在，目标数据库账户需要具有CREATEDB权限；如果数据库存在，目标数据库账户需要数据库的CREATE和CONNECT权限；如果模式存在，需要模式的CREATE和USAGE权限。

迁移对象约束

• 支持的迁移对象有：表、索引、外键、存储过程、函数（不支持C语言函数、带有LEAKPROOF或SUPPORT属性的函数）、视图、约束、触发器、模式、插件、排序规则、编码转换信息、数据类型（不支持基本类型）、聚合函数、操作符、序列、物化视图、统计扩展、规则、事件触发器（仅PostgreSQL11.11及以上的目标库版本支持）、类型转换（不支持二进制强制型的类型转换）、转换信息、文本搜索配置、文本搜索字典、文本搜索解析器（仅PostgreSQL11.11及以上的目标库版本支持）、文本搜索模版（仅PostgreSQL11.11及以上的目标库版本支持）。
• 目前暂不支持表空间、外部数据包装器、外部服务器、用户映射、发布、订阅等对象的迁移，不支持的对象将不被迁移。

• 支持如下字段类型：数字类型、货币类型、字符类型、二进制数据类型、日期/时间类型、布尔类型、枚举类型、几何类型、网络地址类型、位串类型、文本搜索类型、UUID类型、XML类型、JSON类型、数组、复合类型、范围类型。
• 插件迁移将在目标库使用默认版本创建插件对象，仅支持插件的对象的迁移，如果源库在使用某个插件的过程中有新增的插件元数据，请在迁移结束后使用该插件自有的语法重建元数据。
• 不支持迁移源库中的临时表。
• 不支持表名末尾是空格的表。
• 支持在跨大版本间迁移，不允许从高的大版本迁移到低的大版本。

• 不迁移数据库中的系统模式，包括：“pg_”开头的任何模式、“information_schema”，RDS for PostgreSQL增强版还包括“sys”、“utl_raw”、“dbms_lob”、“dbms_output”和“dbms_random”。

源数据库要求

• 源数据库库名不支持如下字符：“+”、“%”、“"”、“'”、“\ ”、“<”和“>”，模式名和表名不支持“"”和“.”。
• 源数据库中同一个数据库下的触发器名称必须唯一。
• 源库的block_size参数不能大于目标库。

• 源库不支持低于PostgreSQL 9.4的版本。
• 源库为RDS for PostgreSQL增强版时，目标库仅支持RDS for PostgreSQL增强版。
• 为保证源数据库连接的安全性，请将源库的ssl参数设置为on，且源库连接用户的认证方式必须为密码口令认证。认证方式的修改方法为在源数据库的“pg_hba.conf”配置文件的所有配置前增加一行配置“host all <src_user_name> <drs_instance_ip>/32 md5”，在源库中通过SUPERUSER用户执行语句“select pg_reload_conf();”或重启数据库实例生效。

目标数据库要求

• 目标库版本不能低于源库版本。
• 目标数据库实例的运行状态必须正常。
• 库级迁移时，如果源库不存在plpgsql之外的插件，目标数据库不能包含与指定数据库同名的数据库；如果源库安装了plpgsql之外的插件，请确保目标库仅在对应数据库中安装了插件，而未创建其他自建对象。
• 表级迁移时，目标数据库不能包含与源库要迁移的对象同名的对象。
• 目标数据库实例必须有足够的磁盘空间。
• 目标数据库和源数据库的lc_monetary参数值需保持一致。
• 目标数据库的block_size参数值必须大于源库中的对应参数值。

操作须知

• 一个迁移任务只能对一个数据库进行数据迁移，如果一个PostgreSQL实例下有多个数据库需要迁移，则需要为每个数据库创建实时迁移任务。
• 表级迁移仅支持表、视图、物化视图和序列的对象选择，表上所创建的约束、索引和规则将和表一起迁移，不迁移触发器。相互关联的数据对象要确保同时迁移或在目标库提前建好，避免迁移因关联对象缺失，导致迁移失败。常见的关联关系：视图引用表、视图引用视图、主外键关联表、表继承子表引用父表、表分区子分区表引用分区表、表自增列引用序列等。
• 迁移过程中，不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。
• 迁移过程中，目标库不能进行写入操作，否则会导致数据不一致。
• 在任务全量迁移阶段，由于迁移期间源库发生的变更无法完全同步到目标库，所以源库不能有任何对象和数据的变更操作，否则会导致目标库与源库的对象和数据状态不一致。
• 在任务启动、任务全量迁移阶段，不允许对源数据库做DDL操作，比如删除表、增加表等，这样会导致任务迁移失败。
• 全量迁移物化视图后，如果目标数据库需要使用物化视图，需要执行以下刷新语句：

  refresh materialized view matviewname;