1
从其它数据库迁移到 PPAS 时可迁移的数据库对象间下表
2
安装 ppas 时会有安装 migreation toolkit 的选项,可以选择安装,也可以到 www.enterprisedb.com 下载安装
3
编辑 /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 #
4
拷贝 oracle 的 jdbc 接口驱动到 /opt/PortgresPlus/9.2AS/jre/lib/ext 里面
注意要拷贝和 jre 版本对应的驱动程序
5
迁移
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
*************************************************************
6
查询迁移结果
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=#
7
下面是 runMTK.sh 的内容,可以看到调用了工具 edb-migrationtoolkit.jar
# ----------------------------------------------------------------------------
# --
# -- Copyright (c) 2004-2012 - EnterpriseDB Corporation. All Rights Reserved.
# --
# ----------------------------------------------------------------------------
/opt/PostgresPlus/9.2AS/jre/bin/java -Dprop=../etc/toolkit.properties -jar edb-migrationtoolkit.jar "$@"
8
下面是 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
-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 #
9
如果看中午帮助信息有歧义就看下面的英文帮助信息吧
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.
-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 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.
-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] 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
-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.