Ora2Pg配置文件详解
说明
此说明基于ora2pg v21.0版本
配置文件说明
| 配置项 | 用途 | 说明 | 默认值/格式 |
|---|---|---|---|
| IMPORT | 导入配置文件 | 将通用配置保存为文件后，其他文件导入后不用再编辑通用配置 | - |
| INPUT_FILE | 导入文件内容 | 只能用于导入函数、存储过程和包定义 | - |
| ORACLE_HOME | 设置Oracle home目录 | ora2pg安装前已配置环境变量，这项基本用不到 | - |
| ORACLE_DSN | Oracle连接地址 | 可用service_name替代sid，实现服务名连接 | dbi:Oracle:host=xx;sid=SIDNAME;port=xx |
| ORACLE_USER | Oracle连接用户名 | - | |
| ORACLE_PWD | Oracle连接密码 | - | |
| USER_GRANTS | 使用非DBA账号时需设为1 | 建议还是使用DBA账号 | 0 |
| DEBUG | 输出迁移过程详细日志到控制台 | 建议开启配置为1 | 0 |
| ORA_INITIAL_COMMAND | 连接oracle后执行指令 | 如读取数据前设置会话参数或者解锁策略。该项可配置多次 | - |
| EXPORT_SCHEMA | 将oracle的schema导出 | 0 | |
| SCHEMA | 配置oracle的schema或owner | 当只有dba账号，迁移其他用户数据时可以用到 | SCHEMA_NAME |
| CREATE_SCHEMA | 将创建schema的sql语句定义在输出文件的开头 | 1 | |
| COMPILE_SCHEMA | 迁移前强制编译指定schema中的无效函数、过程、包和用户定义的类型 | 1 | |
| PG_SCHEMA | 配置postgresql的schema | schema_name | |
| POSTGIS_SCHEMA | 指定用于搜索postgis的schema | schema_name | |
| SYSUSERS | 指定允许使用的oracle的系统用户名 | 默认排除所有oracle系统用户名 | OE,HR |
| LOOK_FORWARD_FUNCTION | 搜索配置的schema的中查找所有函数、存储过程、包的声明,然后继续导出结构 | ora2pg默认只会在当前schema中搜索函数 | SCOTT,OE |
| NO_FUNCTION_METADATA | 强制ora2pg不导出函数的声明 | 将导致ora2pg在重写函数时替换调用。除非是函数导出中断，否则不要启用该项 | 0 |
| NLS_NCHAR | 设置oracle数据库的编码 | AL32UTF8 | |
| CLIENT_ENCODING | 设置PostgreSQL数据库的编码 | UTF8 | |
| TYPE | 配置要导出的类型 | TABLE | |
| DISABLE_COMMENT | 不导出列注释 | 0 | |
| ALLOW | 配置要导出的对象名 | TABLE_TEST | |
| EXCLUDE | 配置导出时要排除的对象名 | OTHER_TABLES | |
| VIEW_AS_TABLE | 将指定视图导出成表 | VIEW_NAME | |
| NO_VIEW_ORDERING | 禁止视图排序 | 默认导出视图前进行排序，防止视图间相互调用导出后定义写入失败.当视图较多时会占据很长时间 | 0 |
| GRANT_OBJECT | 指定要导出权限的对象类型 | 默认是导出所有对象的权限 | TABLE |
| EXTERNAL_TO_FDW | 将外部表导出为file_fdw表 | 如果不想导出这些表，需将该项设为0 | 1 |
| TRUNCATE_TABLE | COPY或INSERT前进行truncate table | 未配置DELETE项时才生效 | 0 |
| DELETE | 写入数据前删除部分数据，可配置数据过滤条件 | TABLE_NAME[DELETE_WHERE_CLAUSE] | |
| USE_TABLESPACE | 强制根据配置的表空间名导出表、索引约束 | 仅当表空间名非TEMP、USER、SYSTEM时生效 | 0 |
| REORDERING_COLUMNS | 对列进行排序，以达到最小化磁盘占用，容纳更多行的目的 | 0 | |
| WHERE | 迁移指定数据，可配置数据过滤条件 | TABLE_NAME[WHERE_CLAUSE] | |
| REPLACE_QUERY | 替换ora2pg默认读取数据的语句，当你有更复杂的读取需求时 | TABLENAME[SQL_QUERY] | |
| CONTEXT_AS_TRGM | 强制使用pg_trgm将Text索引转换为postgresql索引 | pg_trgm会将上下文索引转换为FTS索引和CTXCAT索引 | 0 |
| FTS_INDEX_ONLY | 创建一个基于函数的索引来转换oracle的文本索引 | 1 | |
| FTS_CONFIG | 强制使用文本搜索配置 | 如果未配置则默认检测所有的索引和pg_catelog.english | pg_catalog.french |
| USE_UNACCENT | 0 | ||
| USE_LOWER_UNACCENT | 0 | ||
| SKIP | 在迁移过程关闭postgres的某些功能 | fkeys pkeys ukeys indexes checks | |
| KEEP_PKEY_NAMES | 默认关闭。开启后导出的主键会与oracle库中同名 | 0 | |
| PKEY_IN_CREATE | 开启后会将主键的定义写在表定义中，而不是通过alter table添加 | GreenPlum PostgreSQL建议开启该项 | 0 |
| FKEY_ADD_UPDATE | 配置添加ON UPDATE CASCADE定义到外键定义语句中。Oracle不支持该语法，但Postgresql支持该语法 | never-外键定义与oracle中一致;delete是当外键定义了ON DELETE CASCADE时才会添加ON UPDATE CASCADE选项；always是强制所有选项添加ON UPDATE CASCADE | never delete always |
| FKEY_DEFERRABLE | 将外键导出为可延迟的 | 默认是按原样导出的。如果外键未设置延迟则导出来也是不可延迟的，这可能导致一些文件，建议开启 | 0 |
| DEFER_FKEY | 在数据导出过程延迟所有的外键，导入将在单个事务中完成 | 仅当外键是可延迟且未使用直接导入Postgresql时，该项才有效 | 0 |
| DROP_FKEY | 导入数据前删除外键，导入完成后恢复外键 | 当外键是不可延迟的时候，可使用该项 | 0 |
| DISABLE_SEQUENCE | 禁止序列更新在迁移过程中 | 0 | |
| DISABLE_TRIGGERS | 迁移过程禁止触发器 ，在迁移过程中 | 0 | |
| MODIFY_STRUCT | 只导出某些列的数据 | tables(fields separate by space or comma) | |
| REPLACE_TABLES | 更换要迁移的表名 | ORIG_TB_NAME1:NEW_TB_NAME1 | |
| REPLACE_COLS | 更换要迁移的列名 | TB_NAME(ORIG_COLNAME1:NEW_COLNAME1,ORIG_COLNAME2:NEW_COLNAME2) | |
| PRESERVE_CASE | 保持迁移对象名的大小写 | 0 | |
| INDEXES_SUFFIX | 给索引名添加后缀 | 当索引跟表同名时，建议配置该项 | _idx |
| INDEXES_RENAMING | 按照“表名_列名“的格式给索引重命名 | 当多次使用相同索引名或相同表名的数据库，建议开启 | 0 |
| USE_INDEX_OPCLASS | 强制使用运算符导出varchar2和char列上定义的索引 | 运算符类text_pattern_ops、varchar_pattern_ops和bpchar_pattern_ops支持相应类型上的B树索引。与默认运算符类的不同之处在于，这些值严格按字符进行比较，而不是根据特定于区域设置的排序规则进行比较。这使得这些运算符类适合于在数据库不使用标准“C”语言环境时涉及模式匹配表达式（如或POSIX正则表达式）的查询使用。如果启用值为1，则将强制Ora2Pg使用这些运算符导出varchar2（）和char（）列上定义的所有索引。如果将其设置为大于1的值，则只会更改字符限制大于或等于此值的列的索引。例如，将其设置为128，以便在类型为varchar2（N）的列上创建这类索引，其中N>=128 | 0 |
| PREFIX_PARTITION | 通过父表导出分区表 | Oracle可能分区名相同，但父表名不同。PG是不允许的 | 0 |
| PREFIX_SUB_PARTITION | 如果分区名是子分区名的一部分，禁用该项 | 1 | |
| DISABLE_PARTITION | 开启后会将分区数据全部写到主表 | 默认值是将分区数据写入到PG专用分区表中 | 0 |
| WITH_OID | 建表或将视图导出成表时，强制添加WITH (OIDS) | 0 | |
| ORA_RESERVED_WORDS | 允许使用Oracle关键字转义列名 | audit,comment,references | |
| USE_RESERVED_WORDS | 允许使用pg关键字，关键字将用双引号包起来 | 0 | |
| DISABLE_UNLOGGED | 禁用UNLOGGED，将表导出为普通标 | 默认会将带有NOLOGGING属性的表导出为UNLOGGED表 | 0 |
| PG_DSN | PG连接地址 | dbi:Pg:dbname=test_db;host=localhost;port=5432 | |
| PG_USER | PG用户名 | ||
| PG_PWD | PG密码 | ||
| OUTPUT | 指定导出的数据文件名 | ||
| OUTPUT_DIR | 指定导出的数据文件存放文件夹 | ||
| FILE_PER_CONSTRAINT | 将约束保存在单独的文件中，该文件名格式为“CONSTRAINTS_OUTPUT” | 0 | |
| FILE_PER_INDEX | 将索引保存在单独的文件中，该文件名格式为“INDEXES_OUTPUT” | 0 | |
| FILE_PER_FKEYS | 将外键保存在单独的文件中，该文件名格式为“CONSTRAINT_output.sql” | 0 | |
| FILE_PER_TABLE | 将表数据保存在单独的文件中，该文件名格式为“tablename_OUTPUT” | 0 | |
| FILE_PER_FUNCTION | 将函数或存储过程保存在单独的文件中，该文件名格式为“funcname_OUTPUT” | 0 | |
| BINMODE | 设置导出的文件的编码 | utf8 | |
| STOP_ON_ERROR | 当发生错误时停止导出 | 1 | |
| COPY_FREEZE | 使用COPY FREEZE 代替 COPY | 当-J或者ORACLE_COPIES为1时生效 | 0 |
| CREATE_OR_REPLACE | 导出后使用CREATE OR REPLACE在函数的DDL中 | 1 | |
| PG_INITIAL_COMMAND | 连接到postgresql后执行的初始指令 | 如读取数据前设置会话参数或者解锁策略。该项可配置多次 | |
| DATA_TYPE | 指定oracle的postgresql的数据类型映射关系 | DATE:timestamp | |
| PG_NUMERIC_TYPE | Oracle的NUMBER(p,s) 将转换为real和浮点类型。关闭后则转换为numeric(p,s) | 仅当对精度要求高的时候，关闭该项。因为numeric比real或double慢 | 1 |
| PG_INTEGER_TYPE | Oracle的NUMBER§或NUMBER将转换为smallint 将转换为real和浮点类型 | 1 | |
| DEFAULT_NUMERIC | 不带精度的NUMBER将转换为bigint | 需开启PG_INTEGER_TYPE选项 | bigint |
| ENABLE_MICROSECOND | 如果不想从oracle的时间戳导出毫秒数据，将该项设为0 | 开启后时间格式为“YYYY-MM-DD HH24:MI:SS”，关闭后时间格式为“YYYY-MM-DD HH24:MI:SS.FF” | 1 |
| REPLACE_AS_BOOLEAN | 将某些列的类型改为boolean | 比如当列为number或者char类型，且数据为1时 | TB_NAME1:COL_NAME1 |
| BOOLEAN_VALUES | 当为配置的值时，这些可以被转义为pg的boolean类型数据 | yes:no y:n 1:0 true:false enabled:disabled | |
| REPLACE_ZERO_DATE | 替换0000-00-00 00:00:00 | 默认是替换为null，但当列有非空约束时，需配置该项 | 1970-01-01 00:00:00 |
| MODIFY_TYPE | 修改列的数据类型 | TABLE1:COL3:varchar | |
| TO_NUMBER_CONVERSION | 将NUMBER强制转换为某类型 | numeric | |
| GEN_USER_PWD | 开启后替换用户的默认密码 | 0 | |
| FORCE_OWNER | 强制将对象的使用者设置为Oracle中使用者 | 默认是将连接账号设为OWNER | 0 |
| FORCE_SECURITY_INVOKER | 覆盖函数的SECURITY DEFINER | 默认是使用Oracle中的SECURITY DEFINER | 0 |
| DATA_LIMIT | 配置普通数据每次的抽取量 | 该值修改后需确保有足够内存 | 10000 |
| BLOB_LIMIT | 配置BLOB数据的每次的抽取量 | 默认是抽取普通数据量的10% | 500 |
| NOESCAPE | 默认转义所有非date或time类型的数据，可以设置1禁止转义 | 仅在COPY时生效 | 0 |
| TRANSACTION | 更改数据导出时的事务隔离级别 | 可选值：readonly, readwrite, serializable and committed (read committed) | serializable |
| STANDARD_CONFORMING_STRINGS | 开启后使用(E’…’) 转义数据 | 0 | |
| LONGREADLEN | 配置数据导出的大小限制。当数据超过限制值时会报ORA-24345错误 | 1047552 | |
| LONGTRUNCOK | 开启后可绕过ORA-24345错误 | 0 | |
| NO_LOB_LOCATOR | 禁止该项将使用LOB locators代替BLOB和CLOB类型数据的全部文本信息 | 0 | |
| LOB_CHUNK_SIZE | 设置LOB CHUNK的大小 | 512000 | |
| XML_PRETTY | 开启后强制使用getStringVal()读取XML数据 | 0 | |
| LOG_ON_ERROR | 开启后，数据导出失败后会继续导出 | 0 | |
| TRIM_TYPE | 当数据转为为varchar或text时，对数据开头和结尾的空格进行修剪 | 可选值:LEADING(删除开头的空格)\TRAILING(删除结尾的空格)\BOTH(都删除空格) | BOTH |
| TRIM_CHAR | 设置要移除的字段。默认为空格 | 与TRIM_TYPE字段配合使用 | - |
| FUNCTION_CHECK | 对函数体进行检查 | 关闭该项，将会在导出时添加SET check_function_bodies = false; | |
| NO_BLOB_EXPORT | 不导出blob数据 | 开启该项前需保证blob字段没有设置非空约束 | 0 |
| DATA_EXPORT_ORDER | 指定数据导出的排序依据 | 默认值是name，即按照对象名进行排序后导致；可设置为size按照对象大小排序后导出 | name、size |
| JOBS | 配置导出线程数 | 用于COPY、FUNCTION、PROCEDURE | 1 |
| ORACLE_COPIES | 配置从oracle抽取数据的线程数 | 1 | |
| PARALLEL_TABLES | 配置同时处理的表数量 | 1 | |
| DEFAULT_PARALLELISM_DEGREE | 在oracle每次查询时添加/*+ PARALLEL(tbname, degree) */ | 0 | |
| PARALLEL_MIN_ROWS | 当表的记录数小于该值时，则不会开启多线程模式 | 100000 | |
| DEFINED_PK | 当表进行多线程读取时，通过SELECT * FROM TABLE WHERE MOD(COLUMN, $ORA_COPIES) = ?拆分数据读取，该项用于配置拆分依据。默认是使用主键 | TABLE:COLUMN TABLE:ROUND(COLUMN) | |
| DROP_INDEXES | 迁移前删除索引，在数据导入后重建索引 | 0 | |
| SYNCHRONOUS_COMMIT | 设置是否同步提交 | 默认关闭以提高写入速度。当需要数据直接加载到Postgresql需开启该项 | 0 |
| EXPORT_INVALID | 是否导出不可用的函数、包、存储过程、用户自定义类型 | 0 | |
| PLSQL_PGSQL | 是否启用PLSQL到PLPSQL的转换 | 1 | |
| NULL_EQUAL_EMPTY | 指定null等于空字符串 | 0 | |
| EMPTY_LOB_NULL | 将空的empty数据指定为null | 如果有大量的空lob数据列，建议开启，可以提升迁移速度 | 0 |
| PACKAGE_AS_SCHEMA | 如果你只想将包导出成为一个简单的函数，需将该项设为0 | 关闭该项后，导出后的包命名从package_name.function_name() 变为package_name_function_name() | 1 |
| REWRITE_OUTER_JOIN | 是否重写(+)语法 | 1 | |
| FUNCTION_STABLE | 通过禁用配置指令，可以强制Ora2Pg将这些函数创建为VOLATILE | 1 | |
| COMMENT_COMMIT_ROLLBACK | 是否注释COMMIT或ROLLBACK指令 | 0 | |
| COMMENT_SAVEPOINT | 是否注释SAVEPOINT指令 | 0 | |
| STRING_CONSTANT_REGEXP | 设置要临时替换的regexp列表，以不中断解析器regexp列表必须使用分号作为分隔符 | 默认只替换字符常量，即在两个单引号之间的值 | |
| ALTERNATIVE_QUOTING_REGEXP | 支持字符串文本的替代引用机制（“Q”） | q’{(.*)}’ | |
| AUTONOMOUS_TRANSACTION | 是否使用orafce函数 | 默认ora2pg会重写add_month(), add_year(), date_trunc() and to_char() 等函数 | 0 |
| AUTONOMOUS_TRANSACTION | 允许使用dblink或pg_backgroud插件将自治事务转换为wrapper函数 | 如果想将其转为普通函数，需禁用该项 | 1 |
| PG_VERSION | 指定PostgreSQL的版本 | 11 | |
| BITMAP_AS_GIN | 是否使用gin索引 | 禁用后将使用btree索引。当pg版本大于9.4时该项有效 | 1 |
| PG_BACKGROUND | 是否使用pg_backgroud替代dblink wrapper | 当pg版本大于9.5时有效 | 0 |
| DBLINK_CONN | 配置dblink信息 | port=5432 dbname=pgdb host=localhost user=pguser password=pgpass | |
| PG_SUPPORTS_SUBSTR | 指定是否支持substring() | redshift是不支持substring()，此时需将该项关闭 | 1 |
| AUTODETECT_SPATIAL_TYPE | 是否检测空间列中使用的实际空间类型和维度 | 1 | |
| CONVERT_SRID | 是否自动将srid转换为epsg | 1 | |
| DEFAULT_SRID | 重写默认的epsg srid为4326 | 4326 |