PPAS命令行迁移工具 -

BeiGang

浏览: 225778 次
性别:
来自: 北京

最近访客更多访客>>

u011943534

shimachao

elfhame

karqical

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

PPAS命令行迁移工具

博客分类：

EnterpriseDB

PostgreSQL Oracle migration 迁移

从其它数据库迁移到 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.