介绍

ora_migrator是一个用于db_migrator的插件，它使用oracle_fdw将 Oracle 数据库迁移到 PostgreSQL。

请阅读db_migrator文档以获取使用说明；本文仅涵盖插件的设置以及一般文档中未涵盖的其他功能。

除此之外，ora_migrator还提供从 Oracle 到 PostgreSQL 的复制功能，可用于从 Oracle 进行几乎零停机时间的迁移。有关详细信息，请参阅复制。

请注意，由于 Oracle 中的模式名称通常为大写，因此，您需要为db_migrator函数的only_schemas参数，使用大写的模式名称。

选项

以下选项可用于db_migrate_prepare、db_migrate_mkforeign和db_migrate：

前提条件

•您需要 PostgreSQL 9.5 或更高版本。

•必须安装oracle_fdw和db_migrator扩展。

•必须为访问的 Oracle 数据库定义好外部服务器。

•调用create_oraviews函数以创建外部表的用户，必须具有外部服务器的USAGE权限。

•调用create_oraviews函数的用户必须存在用户映射。

•用户映射中使用的 Oracle 用户，必须具有读取以下 Oracle 系统视图的权限：您可以选择改为授予用户SELECT ANY DICTIONARY系统权限，它包括了上述所有权限。

•DBA_COL_PRIVS

•DBA_CONS_COLUMNS

•DBA_CONSTRAINTS

•DBA_IND_COLUMNS

•DBA_IND_EXPRESSIONS

•DBA_INDEXES

•DBA_MVIEWS

•DBA_MVIEW_LOGS

•DBA_PROCEDURES

•DBA_SEGMENTS

•DBA_SEQUENCES

•DBA_SOURCE

•DBA_TAB_COLUMNS

•DBA_TAB_PRIVS

•DBA_TABLES

•DBA_TRIGGERS

•DBA_USERS

•DBA_VIEWS

•要使用复制，用户必须具有CREATE TABLE和CREATE TRIGGER权限。若要对不属于指定 Oracle 用户的表使用复制，该用户必须具有CREATE ANY TABLE、CREATE ANY INDEX、CREATE ANY TRIGGER、DROP ANY TABLE、DROP ANY TRIGGER和SELECT ANY TABLE权限（这是创建、删除日志记录表和触发器所必需的）。

扩展创建的对象

迁移函数

db_migrator回调函数db_migrator_callback()，返回扩展提供的迁移函数。有关详细信息，请参阅db_migrator文档。

“元数据视图创建函数”create_oraviews，会在 FDW 阶段创建一些附加对象，这些对象提供了对 Oracle 迁移有帮助的信息：

包定义

packages  package_name  is_body  source 

•is_body，对于包规范定义是FALSE，对于包体定义是TRUE

此视图可用于简化包对象的转换。

段

segments  segment_name  segment_type  bytes  

该外表对于评估 Oracle 中表和索引的大小最有用。

迁移成本估算

migration_cost_estimate  task_type task_content task_unit migration_hours   

该视图有助于评估一个 Oracle 数据库的迁移成本。

其他对象

表函数 oracle_test_table

此函数测试一个 Oracle 表是否存在潜在的迁移问题。您必须在db_migrate_prepare之后运行它。

参数为：

•server：Oracle 外部服务器的名称

•schema：模式名称

•table_name：表名

•pgstage_schema（默认是pgsql_stage）：由db_migrate_prepare创建的 PostgreSQL 阶段的名称。

schema和table_name必须是 PostgreSQL 阶段中与tables表同名的列中的值。

这是一个表函数，返回有问题的行在 Oracle 中的 ROWID，以及一条描述问题的消息。

目前测试发现有两个问题：

•字符串列中的零字节chr(0)

•不在数据库编码中的字符串列中的值

函数 oracle_migrate_test_data

此函数对 PostgreSQL 暂存模式中的所有表调用oracle_test_table，并将结果记录在 FDW 阶段的test_error表中（在清空表后）。

此外，在 FDW 阶段，会有一份错误摘要添加到表test_error_stats中。在清理 Oracle 中的脏数据时，这对于衡量随时间推移的进度非常有用。

该函数会返回遇到的错误总数。

函数参数为：

•server：Oracle 外部服务器的名称

•staging_schema（默认是fdw_stage）：远程暂存模式的名称

•pgstage_schema（默认是pgsql_stage）：由oracle_migrate_prepare创建的 PostgreSQL 阶段的名称。

•only_schemas（默认是NULL）：应迁移到 PostgreSQL 的 Oracle 模式名称数组。如果为 NULL，则会处理除 Oracle 系统模式之外的所有模式。名称必须与它们出现在 Oracle 中的名称相同，通常为大写。

表 oracle_test_table 和 test_error_stats

这些表包含运行oracle_migrate_test_data生成的单个结果和汇总结果。

复制函数

函数 oracle_replication_start

此函数在 Oracle 和 PostgreSQL 数据库中创建复制所需的所有对象。PostgreSQL 对象将创建在 Postgres 暂存模式中，Oracle 对象与复制的表位于同一模式中。

此函数应在db_migrate_tables之前调用，并且在启动oracle_replication_start和调用db_migrate_tables之间，不应在 Oracle 上发生任何数据修改活动。

函数参数为：

•server：Oracle 外部服务器的名称

•pgstage_schema（默认是pgsql_stage）：由oracle_migrate_prepare创建的 PostgreSQL 阶段的名称

该函数创建的对象包括：

•一个 PostgreSQL 外表__ReplicationEnd，该表会显示一个时间戳，保证能早于 Oracle 上最老的活跃事务

•一个 PostgreSQL 表__ReplicationStart，用于存储下一次复制追赶的起点

对于 Postgres 阶段的tables表中设置migrate为TRUE的每个表，将创建以下对象：

•一个 Oracle 表__Log_<tablename>，用于收集对<tablename>的更改

•一个在<tablename>上面的 Oracle 触发器__Log_<tablename>_TRIG

•Oracle 记录更改的日志表，在 PostgreSQL 上的外表__Log_<schema>/<tablename>

函数 oracle_catchup_table

将特定时间间隔内更改的数据，从 Oracle 表复制到 PostgreSQL。

这要求oracle_replication_start已创建所需的对象，并且数据迁移已完成。

参数：

•schema：迁移表的模式

•table_name：迁移表的名称

•from_ts：复制该时间点的更改

•to_ts：复制该时间点以前（包括该时间点）的更改

这是一个“底层”函数，由oracle_replication_catchup调用；如果要通过为不同的表并发运行它，来并行化追赶任务，则可以使用它。

函数 oracle_catchup_sequence

参数：

•schema：迁移序列的模式

•sequence_name：迁移序列的名称

•staging_schema（默认是fdw_stage）：远程暂存模式的名称

在远程端查询 Oracle 序列的当前值，并将迁移的序列设置为该值。

函数 oracle_replication_catchup

复制自上次同步到 PostgreSQL 所有 Oracle 表和序列中的所有更改。

开始时间戳取自__ReplicationStart，结束时间戳取自__ReplicationEnd（包含最近的安全时间戳）。成功完成后，复制结束时间将保存到__ReplicationStart，以便下次使用。

参数：

•staging_schema（默认是fdw_stage）：远程暂存模式的名称

•pgstage_schema（默认是pgsql_stage）：由oracle_migrate_prepare创建的 PostgreSQL 阶段的名称

您可以在oracle_replication_start完成后随时调用此函数。

除非数据库中没有触发器或外键约束，否则应在调用此函数时，将配置参数session_replication_role设置为replica。这样就不会触发触发器，并且不会检查外键约束。

oracle_replication_catchup在 Oracle 上使用SERIALIZABLE隔离级别，因此它可以看到 Oracle 数据库的固定快照，并且数据在 PostgreSQL 端是一致的，即使 Oracle 数据库被其他并发的会话修改。

如果要使用复制进行接近零停机时间的迁移，请在短时间内连续调用两次，并确保在第二次调用期间 Oracle 上没有数据修改活动。第二次追赶完成后，您可以立即将应用程序切换到 PostgreSQL。

函数 oracle_replication_finish

删除 PostgreSQL 和 Oracle 中由oracle_replication_start创建的所有对象。

这可用于在完成从 Oracle 的迁移后进行清理。

•server：Oracle 外部服务器的名称

•pgstage_schema（默认是pgsql_stage）：由oracle_migrate_prepare创建的 PostgreSQL 阶段的名称

限制

并非所有 Oracle 分区选项都受ora_migrator支持。PostgreSQL 仅支持列表、哈希和范围分区，不支持其他分区策略。此外，不支持使用两列或更多列的分区键进行列表和范围分区。当ora_migrator遇到一个无法迁移的分区模式时，会将该表迁移到一个非分区表。

复制

ora_migrator提供了一个从 Oracle 到 PostgreSQL 的简单的基于触发器的复制功能。

这可用于将数据库从 Oracle 迁移到 PostgreSQL，几乎没有停机时间。

操作步骤如下：

•按照db_migrator文档中所述，通过调用db_migrate_prepare和db_migrate_mkforeign来准备迁移。

•暂停 Oracle 数据库上的所有数据修改活动。这是需要的，因为 Oracle 不支持事务性 DDL。

•然后调用oracle_replication_start以设置所有必需的对象。这将在 Oracle 数据库中创建日志表和触发器。

•然后像往常一样使用db_migrate_tables开始数据迁移。一旦db_migrate_tables启动，Oracle 数据库上的数据修改活动就可以恢复。迁移将使用SERIALIZABLE事务隔离级别运行，因此迁移的数据将是一致的。请确保 Oracle 上有足够的 UNDO 存储空间，否则数据迁移可能会失败。

•使用db_migrate_constraints迁移约束和索引；按照db_migrator文档中所述，迁移其他对象。

•您可以随时调用oracle_replication_catchup，以将更改的数据从 Oracle 传输到 PostgreSQL。这需要为所有受影响的表调用oracle_catchup_table，因此要并行化操作，您可以直接为所有受影响的表调用下层的函数。请注意，追赶时不会清理 Oracle 上的日志表。为避免 PostgreSQL 中的外键约束问题，请在运行oracle_catchup_table时，确保将配置参数session_replication_role设置为replica。对于接近零停机时间的迁移，在 Oracle 数据库上没有数据修改活动时，还必须执行最后一次oracle_replication_catchup调用。调用后，将应用程序切换到 PostgreSQL。

•要结束复制，请调用oracle_replication_finish。这将会删除为复制创建的所有对象。

•最后，调用db_migrate_finish，以删除所有辅助对象。