PPAS命令行迁移工具

阅读更多

 

1

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


PPAS命令行迁移工具_第1张图片  

 

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 如果空字符是列值得一部分,那么通过 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 #

 

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 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.

 

 



  • PPAS命令行迁移工具_第2张图片
  • 大小: 24.6 KB
  • 查看图片附件

你可能感兴趣的:(PostgreSQL,Oracle,migration,迁移)