PPAS命令行迁移工具

最新推荐文章于 2022-12-13 17:00:09 发布

最新推荐文章于 2022-12-13 17:00:09 发布 · 322 阅读

文章标签：

#PostgreSQL #Oracle #migration #迁移

EnterpriseDB 专栏收录该内容

2 篇文章

订阅专栏

本文介绍了一种从Oracle数据库迁移到PPAS(Postgres Plus Advanced Server)的方法，包括安装迁移工具、配置连接信息、执行迁移步骤及查询结果等关键流程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

从其它数据库迁移到 PPAS 时可迁移的数据库对象间下表

安装 ppas 时会有安装 migreation toolkit 的选项，可以选择安装，也可以到 www.enterprisedb.com 下载安装

编辑 /opt/PostgresPlus/9.2AS/etc/toolkit.properties

linux-np3p:/opt/PostgresPlus/9.2AS # cat -n etc/toolkit.properties

SRC_DB_URL=jdbc:oracle:thin:@192.168.1.127:1521:orcl

SRC_DB_USER=testuser

SRC_DB_PASSWORD=testuserpw

TARGET_DB_URL=jdbc:edb://localhost:5444/testdb1

TARGET_DB_USER=testuser

TARGET_DB_PASSWORD=123456

linux-np3p:/opt/PostgresPlus/9.2AS #

拷贝 oracle 的 jdbc 接口驱动到 /opt/PortgresPlus/9.2AS/jre/lib/ext 里面

注意要拷贝和 jre 版本对应的驱动程序

迁移

linux-np3p:/opt/PostgresPlus/9.2AS/bin # ./runMTK.sh testuser

源数据库连接信息 ...

连接 =jdbc:oracle:thin:@192.168.1.127:1521:orcl

用户 =TESTUSER

密码 =******

目标数据库连接信息 ...

连接 =jdbc:edb://localhost:5444/testdb2

用户 =testuser

密码 =******

正在连接源 Oracle 数据库服务器 ...

正在连接目标 EnterpriseDB 数据库服务器 ...

正在导入 Redwood 架构 testuser...

正在创建架构 ...testuser

正在创建表 ...

正在创建表 : TEST1

已创建 1 个表。

正在以 8 MB 批次大小加载表数据 ...

正在加载表 : TEST1 ...

[TEST1] 已迁移 2 行。

[TEST1] 表数据加载摘要 : 时间总计 ( 秒 ): 0.375 行数总计 : 2

数据加载摘要 : 时间总计 ( 秒 ): 1.111 行数总计 : 2 大小总计 (MB): 0.0

已成功导入架构 testuser 。

正在创建用户 : TESTUSER

创建用户 TESTUSER 时发生错误

在迁移进程中有一至多个架构对象无法导入。有关更多详细信息，请参阅迁移输出信息。

迁移日志已保存到 /root/.enterprisedb/migration-toolkit/logs

******************** 迁移摘要 ********************

Tables: 1 来自 1

Users: 0 来自 1

全部对象 : 2

成功计数 : 1

失败计数 : 1

失败对象列表

======================

Users

--------------------

1. TESTUSER

*************************************************************

查询迁移结果

linux-np3p:/opt/PostgresPlus/9.2AS/bin # ./psql -U testuser testdb1

用户 testuser 的口令：

psql (9.2.0.1)

输入 "help" 来获取帮助信息 .

testdb2=# select * from test1;

id | xname

----+--------------

1 | test / gaga

2 | test ／ gaga

(2 行记录 )

testdb2=#

下面是 runMTK.sh 的内容，可以看到调用了工具 edb-migrationtoolkit.jar

# ----------------------------------------------------------------------------

# --

# ----------------------------------------------------------------------------

/opt/PostgresPlus/9.2AS/jre/bin/java -Dprop=../etc/toolkit.properties -jar edb-migrationtoolkit.jar "$@"

下面是 migreation toolkit 的帮助信息，列出了可选参数

linux-np3p:/opt/PostgresPlus/9.2AS # jre/bin/java -jar bin/edb-migrationtoolkit.jar -help

EnterpriseDB Migration Toolkit (Build 46)

用法 : runMTK [- 选项 ] SCHEMA

若未指定任何选项，则将导入完整的架构。

其中，选项包括 :

-help 显示应用程序的命令行用法。

-version 显示应用程序版本信息。

-verbose [on|off] 以标准输出显示应用程序日志消息 ( 默认值 : on) 。

-schemaOnly 只导入架构对象定义。

-dataOnly 只导入表数据。若指定了 -tables ，则只导入所选表的数据。注意 : 如果对目标表定义了任何外键约束，则此选项需与 -truncLoad 选项一起使用。

-sourcedbtype db_type The -sourcedbtype option specifies the source database type. db_type may be one of the following values: mysql, oracle, sqlserver, sybase, postgresql, enterprisedb. db_type is case-insensitive. By default, db_type is oracle.

-targetdbtype db_type The -targetdbtype option specifies the target database type. db_type may be one of the following values: oracle, sqlserver, postgresql, enterprisedb. db_type is case-insensitive. By default, db_type is enterprisedb.

-allTables 导入所有表。

-tables LIST 导入以逗号分隔的表列表。

-constraints 导入表约束。

-indexes 导入表索引。

-triggers 导入表触发器。

-allViews 导入所有视图。

-views LIST 导入以逗号分隔的视图列表。

-allProcs 导入所有存储过程。

-procs LIST 导入以逗号分隔的存储过程列表。

-allFuncs 导入所有函数。

-funcs LIST 导入以逗号分隔的函数列表。

-allPackages 导入所有包。

-packages LIST 导入以逗号分隔的包列表。

-allSequences 导入所有序列。

-sequences LIST 导入以逗号分隔的序列列表。

-targetSchema NAME 目标架构的名称 ( 默认 : 目标架构以源架构命名 ) 。

-allDBLinks 导入所有数据库链接。

-allSynonyms It enables the migration of all public and private synonyms from an Oracle database to an Advanced Server database. If a synonym with the same name already exists in the target database, the existing synonym will be replaced with the migrated version.

-allPublicSynonyms It enables the migration of all public synonyms from an Oracle database to an Advanced Server database. If a synonym with the same name already exists in the target database, the existing synonym will be replaced with the migrated version.

-allPrivateSynonyms It enables the migration of all private synonyms from an Oracle database to an Advanced Server database. If a synonym with the same name already exists in the target database, the existing synonym will be replaced with the migrated version.

-dropSchema [true|false] 若架构已存在于目标数据库中，则删除此架构 ( 默认值 : false) 。

-truncLoad 此选项对目标表禁用任何约束，并且在导入新数据之前先截断表中的数据。此选项只能与 -dataOnly 一起使用。

-safeMode 使用纯 SQL 语句，以安全模式传输数据。

-copyDelimiter 在加载表数据时，指定一个字符作为复制命令中的分隔符。默认值为 \t

-batchSize 指定“批量插入”要使用的“批次大小”。有效值为 1-1000 ，默认批次大小为 1000 ，如果出现“内存不足”异常，则可以降低此值

-cpBatchSize 指定复制命令要使用的“批次大小”，以 MB 为单位。有效值大于 0 ，默认批次大小为 8 MB

-fetchSize 指定提取大小 ( 每次应从结果集中提取的行数 ) 。当数据表含有数百万个行，而您想避免发生内存不足错误时，可以使用此选项。

-filterProp 包含表 where 子句的属性文件。

-skipFKConst 跳过外键约束的迁移。

-skipCKConst 跳过检查约束条件的迁移。

-ignoreCheckConstFilter 在缺省的情况下 MTK 不从 Sybase 中迁移检查约束和缺省子句，使用这个选项可以关闭这个过滤功能。

-fastCopy 略过 WAL 日志记录，以优化方式执行 COPY 操作，默认情况下禁用。

-customColTypeMapping LIST 使用以分号分隔的列表表示的自定义类型映射，其中每个条目都使用 COL_NAME_REG_EXPR=TYPE 对来指定，例如 .*ID=INTEGER

-customColTypeMappingFile PROP_FILE 由属性文件表示的自定义类型映射，其中每个条目都使用 COL_NAME_REG_EXPR=TYPE 对来指定，例如 .*ID=INTEGER

-offlineMigration [DDL_PATH] 这将执行脱机迁移并将 DDL 脚本保存在文件中供以后执行。默认情况下，如果要求后跟 -offlineMigration 选项以及自定义路径，则脚本文件将保存在用户主文件夹下。

-logDir LOG_PATH 指定用于保存日志文件的自定义路径。默认情况下，日志文件保存在工作目录中的“ logs ”文件夹下。

-copyViaDBLinkOra 此选项可用来通过使用 dblink_ora COPY 命令复制数据。此选项仅限用在从 Oracle 到 EnterpriseDB 迁移模式中。

-singleDataFile Use single SQL file for offline data storage for all tables. This option cannot be used in COPY format.

-allUsers 从源数据库导入所有用户和角色。

-users LIST 从源数据库导入选定用户 / 角色。 LIST 是一个用逗号分隔的用户 / 角色名称列表，如 -users MTK,SAMPLE

-allRules 从源数据库导入所有规则。

-rules LIST 从源数据库导入选定规则。 LIST 是一个用逗号分隔的名称列表，如 -rules high_sal_emp,low_sal_emp

-allGroups 从源数据库导入所有组。

-groups LIST 从源数据库导入选定组。 LIST 是一个用逗号分隔的组名称列表，如 -groups acct_emp,mkt_emp

-allDomains 从源数据库导入所有域、枚举和复合类型。

-domains LIST 从源数据库导入所选域、枚举和复合类型。 LIST 是一个用逗号分隔的域名称列表，如 -domains d_email,d_dob, mood

-objecttypes 导入用户定义的对象类型。

-replaceNullChar <CHAR> 如果空字符是列值得一部分，那么通过 JDBC 协议迁移数据就会失败 . 这个选项可以使用用户指定的字符来替代空字符串。

-importPartitionAsTable [LIST] 通过使用这个选项能够将 Oracle 中的分区表以常规表的形式导入到 EnterpriseDB 中。为了在所选择表集合上的应用规则，在选项后面应跟随以逗号分隔的表名列表。

-enableConstBeforeDataLoad 通过使用这个选项可以在数据导入前重新启用约束 ( 和触发器 ). 当要迁移的表在 EnterpriseDB 中对应的是一张分区表时，使用这个选项是非常有用的。

-checkFunctionBodies [true|false] 设置为 false 时，将禁用创建函数过程中的函数体验证，从而避免在函数包含向前参考时发生错误。目标数据库为 Postgres/EnterpriseDB 时适用，默认值为 true 。

-retryCount VALUE 指定 MTK 迁移由于跨架构相关性而失败的对象的重试次数。 VALUE 参数应该大于 0 ，默认值为 2 。

-analyze 它将对目标 Postgres 或 Postgres Plus Advanced Server 数据库调用 ANALYZE 操作。 ANALYZE 收集用于有效查询计划的迁移表的统计信息。

-vacuumAnalyze 它将对目标 Postgres 或 Postgres Plus Advanced Server 数据库调用 VACUUM 和 ANALYZE 操作。 VACUUM 回收非活动元组存储， ANALYZE 收集用于有效查询计划的迁移表的统计信息。

-loaderCount VALUE 指定并行执行数据加载的作业 ( 线程 ) 数目。 VALUE 参数应该大于 0 ，默认值为 1 。

数据库连接信息 :

应用程序将从文件 toolkit.properties 中读取源和目标数据库服务器的连接信息 .

更多的信息参见 MTK 的自述文档 .

linux-np3p:/opt/PostgresPlus/9.2AS #

如果看中午帮助信息有歧义就看下面的英文帮助信息吧

ot@host1 9.2AS]# jre/bin/java -jar bin/edb-migrationtoolkit.jar -help

EnterpriseDB Migration Toolkit (Build 46)

Usage: runMTK [-options] SCHEMA

If no option is specified, the complete schema will be imported.

where options include:

-help Display the application command-line usage.

-version Display the application version information.

-verbose [on|off] Display application log messages on standard output (default: on).

-schemaOnly Import the schema object definitions only.

-dataOnly Import the table data only. When -tables is in place, it imports data only for the selected tables. Note: If there are any FK constraints defined on target tables, use -truncLoad option along with this option.

-allTables Import all tables.

-tables LIST Import comma-separated list of tables.

-constraints Import the table constraints.

-indexes Import the table indexes.

-triggers Import the table triggers.

-allViews Import all Views.

-views LIST Import comma-separated list of Views.

-allProcs Import all stored procedures.

-procs LIST Import comma-separated list of stored procedures.

-allFuncs Import all functions.

-funcs LIST Import comma-separated list of functions.

-allPackages Import all packages.

-packages LIST Import comma-separated list of packages.

-allSequences Import all sequences.

-sequences LIST Import comma-separated list of sequences.

-targetSchema NAME Name of the target schema (default: target schema is named after source schema).

-allDBLinks Import all Database Links.

-dropSchema [true|false] Drop the schema if it already exists in the target database (default: false).

-truncLoad It disables any constraints on target table and truncates the data from the table before importing new data. This option can only be used with -dataOnly.

-safeMode Transfer data in safe mode using plain SQL statements.

-copyDelimiter Specify a single character to be used as delimiter in copy command when loading table data. Default is \t

-batchSize Specify the Batch Size to be used by the bulk inserts. Valid values are 1-1000, default batch size is 1000, reduce if you run into Out of Memory exception

-cpBatchSize Specify the Batch Size in MB, to be used in the Copy Command. Valid value is > 0, default batch size is 8 MB

-fetchSize Specify fetch size in terms of number of rows should be fetched in result set at a time. This option can be used when tables contain millions of rows and you want to avoid out of memory errors.

-filterProp The properties file that contains table where clause.

-skipFKConst Skip migration of FK constraints.

-skipCKConst Skip migration of Check constraints.

-ignoreCheckConstFilter By default MTK does not migrate Check constraints and Default clauses from Sybase, use this option to turn off this filter.

-fastCopy Bypass WAL logging to perform the COPY operation in an optimized way, default disabled.

-customColTypeMapping LIST Use custom type mapping represented by a semi-colon separated list, where each entry is specified using COL_NAME_REG_EXPR=TYPE pair. e.g. .*ID=INTEGER

-customColTypeMappingFile PROP_FILE The custom type mapping represented by a properties file, where each entry is specified using COL_NAME_REG_EXPR=TYPE pair. e.g. .*ID=INTEGER

-offlineMigration [PATH] This performs offline migration and saves the DDL/DML scripts in files for a later execution. By default the script files will be saved under user home folder, if required follow -offlineMigration option with a custom path.

-logDir LOG_PATH Specify a custom path to save the log file. By default, on Linux the logs will be saved under folder $HOME/.enterprisedb/migration-toolkit/logs. In case of Windows logs will be saved under folder %HOMEDRIVE%%HOMEPATH%\.enterprisedb\migration-toolkit\logs.

-copyViaDBLinkOra This option can be used to copy data using dblink_ora COPY commad. This option can only be used in Oracle to EnterpriseDB migration mode.

-singleDataFile Use single SQL file for offline data storage for all tables. This option cannot be used in COPY format.

-allUsers Import all users and roles from the source database.

-users LIST Import the selected users/roles from the source database. LIST is a comma-separated list of user/role names e.g. -users MTK,SAMPLE

-allRules Import all rules from the source database.

-rules LIST Import the selected rules from the source database. LIST is a comma-separated list of rule names e.g. -rules high_sal_emp,low_sal_emp

-allGroups Import all groups from the source database.

-groups LIST Import the selected groups from the source database. LIST is a comma-separated list of group names e.g. -groups acct_emp,mkt_emp

-allDomains Import all domain, enumeration and composite types from the source database.

-domains LIST Import the selected domain, enumeration and composite types from the source database. LIST is a comma-separated list of domain names e.g. -domains d_email,d_dob, mood

-objecttypes Import the user-defined object types.

-replaceNullChar <CHAR> If null character is part of a column value, the data migration fails over JDBC protocol. This option can be used to replace null character with a user-specified character.

-importPartitionAsTable [LIST] Use this option to import Oracle Partitioned table as a normal table in EnterpriseDB. To apply the rule on a selected set of tables, follow the option by a comma-separated list of table names.

-enableConstBeforeDataLoad Use this option to re-enable constraints (and triggers) before data load. This is useful in the scenario when the migrated table is mapped to a partition table in EnterpriseDB.

-checkFunctionBodies [true|false] When set to false, it disables validation of the function body during function creation, this is to avoid errors if function contains forward references. Applicable when target database is Postgres/EnterpriseDB, default is true.

-retryCount VALUE Specify the number of re-attempts performed by MTK to migrate objects that failed due to cross-schema dependencies. The VALUE parameter should be greater than 0, default is 2.

-analyze It invokes ANALYZE operation against a target Postgres or Postgres Plus Advanced Server database. The ANALYZE collects statistics for the migrated tables that are utilized for efficient query plans.

-vacuumAnalyze It invokes VACUUM and ANALYZE operations against a target Postgres or Postgres Plus Advanced Server database. The VACUUM reclaims dead tuple storage whereas ANALYZE collects statistics for the migrated tables that are utilized for efficient query plans.

-loaderCount VALUE Specify the number of jobs (threads) to perform data load in parallel. The VALUE parameter should be greater than 0, default is 1.

Database Connection Information:

The application will read the connectivity information for the source and target database servers from toolkit.properties file.

Refer to MTK readme document for more information.