兼容Oracle_exp_imp的导出导入工具手册.pdf

兼容 Oracle exp/imp 的导出导入工具手册 金仓数据库管理系统 KingbaseES 文档版本：V9（V009R001C001B0024） 发布日期：2023 年 10 月 12 日 北京人大金仓信息技术股份有限公司 目 目 录 录 第 1 章 前言 1 1.1 适用读者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 术语 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.4 手册约定 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 第 2 章 概述 3 2.1 使用场景 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 使用条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2.1 Windows 平台注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2.2 servicename 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.2.2.1 Windows 设置 servicename 的方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.2.2.2 Linux 设置 servicename 的方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 权限问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2.3 第 3 章 exp/imp 工具介绍 6 3.1 运行环境说明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.2 逻辑架构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.2.1 本地备份 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 3.2.2 远程备份 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 3.3 工具的构成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.4 工具运行的配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 第 4 章 功能与实践 4.1 4.2 10 exp 功能与实践 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1.1 完全模式导出 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1.2 用户模式导出 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1.3 表模式导出 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 imp 功能与实践 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.2.1 完全模式导入 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.2.2 用户模式导入 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.2.3 表模式导入 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 I 目 第 5 章 附录 A：exp 导出参数说明 录 12 5.1 USERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 5.2 OWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.3 TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.4 ROWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 5.5 FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 5.6 FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 5.7 PARFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 5.8 LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 5.9 QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 5.10 CONSTRAINTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 5.11 INDEXES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 5.12 TRIGGERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 5.13 KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 5.14 -? 或--help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 5.15 -V 或--version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 第 6 章 附录 B：imp 导入参数说明 19 6.1 USERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 6.2 FROMUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 6.3 FROMUSERCASESENSITIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6.4 TOUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6.5 TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 6.6 ROWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 6.7 FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.8 IGNORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.9 FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.10 PARFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.11 LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.12 CLEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.13 ONLYVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.14 RECREATEVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.15 KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.16 -? 或--help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.17 -V 或--version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 版权声明 26 服务周期承诺 27 II 第 1 章 前言 1 第 章 前言 本文描述了 KingbaseES 兼容 oracle 逻辑备份 (exp/imp) 工具的导出、导入工具的应用场景和详细使用方法。 前言部分包含以下主题： • 适用读者 • 相关文档 • 术语 • 手册约定 1.1 适用读者 KinbaseES 兼容 oracle exp/imp 的导出导入工具手册适用于所有使用 KingbaseES 的数据库管理员，应用程序开 发者，安全管理员，系统运维或管理人员。 1.2 相关文档 1.3 术语 术语 定义 dmp 文件、dump 文件 exp 工具导出的带有数据库对象和内容的二进制文件, 可用于数据的逻辑备份。 1 第 1 章 前言 1.4 手册约定 本文档中可能出现“注意、提示、警告、另请参阅”等标志，它们所代表的含义如下： 注意: 用于突出重要/关键信息、最佳实践等。 提示: 用于突出小窍门、捷径等。 警告: 用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其 它不可预知的结果。 另请参阅: 用于突出参考、参阅等。 以下程序代码书写约定适用于本文档： 符号 说明 [] 表示包含一个或多个可选项。不需要输入中括号本身。 {} 表示包含两个以上（含两个）的候选，必须在其中选取一个。不需要输入花括号本身。 | 分割中括号或者花括号中的两个或两个以上选项。不需要输入“|”本身。 ... 表示其之前的元素可以被重复。 斜体 表示占位符或者需要提供特定值的变量。 大写 表示系统提供的元素，以便与用户定义的元素相互区分。除出现在方括号中的元素外，应当按 照顺序逐字输入。当然，部分元素在系统中是大小写不敏感的，因此用户可以根据系统说明以 小写形式输入。 小写 表示由用户提供的元素。 2 第 2 章 概述 2 第 章 概述 本工具是用于兼容 Oracle 的逻辑导出导入工具 exp/imp 的，旨在对原 Oracle exp/imp 指令不作修改（或者最 小化修改）的情况下实现对 KingbaseES 的逻辑导出导入。但因数据库架构和实现原理的差异，KingbaseES 的 exp/ imp 工具只做到了主要功能的兼容，有些参数的复杂使用上有一些限制条件，因此除非不得不使用这两个工具的特殊 情况，应优先使用 KingbaseES 的另外的逻辑导出导入工具 sys_dump、sys_restore 。 本章节包含以下内容： • 使用场景 • 使用条件 2.1 使用场景 exp/imp 设计的目的是为了尽最大可能兼容 Oracle 的 exp/imp 工具，适用于基于 Oracle 数据库的应用系统兼容 KingbaseES ，应用系统中会有逻辑导出导入功能，它的功能实现是调用的 exp/imp 工具，应用系统不想再实现一遍 针对 KingbaseES 的逻辑导出导入功能模块时，可以直接使用 KingbaseES 的 exp/imp 工具。 2.2 使用条件 exp/imp 兼容 Windows 和 Linux 平台，使用时需要配置 servicename，并且在 Windows 平台使用时需要额外设 置 PATH 路径。 2.2.1 Windows 平台注意事项 将 exp.exe、imp.exe 所在目录添加到系统的 Path 环境变量中： 以 Windows 7 为例，控制面板–系统–高级系统设置–高级–环境变量–系统变量–Path，双击 Path 在弹出 框的变量值中追加 exp.exe、imp.exe 所在目录（注意使用英文字符分号间隔不同的路径），确定保存。 3 第 2 章 概述 注意: 若没有设置 Path，执行任何 exp.exe、imp.exe 命令，都会报错“无法将 imp.exe/ exp.exe 项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后重试”。 2.2.2 servicename 配置 2.2.2.1 Windows 设置 servicename 的方法 注意: 以下操作针对当前用户名为 kingbase 的情景。 在 cmd 命令行窗口下执行 set KINGBASE_SYSCONFDIR=C:\\Users\\kingbase\\ 在 C:\Users\kingbase\新建 sys_service.conf 文件（注意文件名与 Linux 的情况不同，开头无点） [kingbase] host=192.168.45.162 port=54321 dbname=xyz 然后在该 cmd 命令行窗口下就可以使用 exp/imp 了。 或者可以设置全局的环境变量，以 Windows 7 为例，控制面板–系统和安全–系统–高级系统设置–高 级–环境变量–新建用户变量/新建系统变量，填入“变量名”（KINGBASE_SYSCONFDIR），“变量值”（C: \Users\kingbase\），确定保存。 4 第 2 章 概述 2.2.2.2 Linux 设置 servicename 的方法 默认使用 ~/.sys_service.conf 文件（注意文件名与 Windows 的情况不同，开头有点） [kingbase] host=192.168.45.162 port=54321 dbname=test 注意: dbname 不支持指定多个数据库（dbname=test1,test2），也不支持多次指定 dbname（dbname=test1 换行后 再次指定 dbname=test2）。 2.2.3 权限问题 使用 imp 时请留意导入用户的权限，若 dmp 文件有多个模式，导入用户是普通用户就没有创建模式的权限，就 只会导入 public 模式的数据库对象。 5 第 3 章 EXP/IMP 工具介绍 3 第 章 exp/imp 工具介绍 本章节包含以下内容： • 运行环境说明 • 逻辑架构 • 工具的构成 • 工具运行的配置 3.1 运行环境说明 exp/imp 在 KingbaseES 发布包内，支持 Windows 和常见 Linux 操作系统。 3.2 逻辑架构 exp 工具是由用户直接执行，或者通过脚本等第三方工具间接触发执行，exp 连接到指定数据库收集数据对象或 内容，最后将这些信息汇总写入到 dmp 文件中。 6 第 3 章 EXP/IMP 工具介绍 imp 工具也是由用户直接执行，或者通过脚本等第三方工具间接触发执行，从 exp 导出的 dump 文件中获取具体 的数据库对象和内容等信息，并按参数要求将这些信息导入到数据库中。 7 第 3 章 EXP/IMP 工具介绍 3.2.1 本地备份 exp 工具本地备份是指工具和数据库服务器在同一台机器上，exp 支持导出本地数据库。 3.2.2 远程备份 exp 工具远程备份是指工具和数据库服务器不在同一台机器上，通常来说是在一台机器上只安装了 KingbaseES 的工具包，可使用工具包内的 exp 工具导出远程的数据库。 8 第 3 章 EXP/IMP 工具介绍 3.3 工具的构成 exp：逻辑导出工具，支持完全模式、用户模式和表模式的导出。 imp：逻辑导入工具，支持完全模式、用户模式和表模式的导入。 3.4 工具运行的配置 exp/imp 的运行需要提前设置好 servicename，请参见servicename 配置 。 9 第 4 章 功能与实践 4 第 章 功能与实践 本章节包含以下内容： • exp 功能与实践 • imp 功能与实践 4.1 exp 功能与实践 exp 支持完全模式、用户模式和表模式的导出功能，相关参数详细说明请参见附录 A：exp 导出参数说明 。 4.1.1 完全模式导出 完全模式会导出 servicename 中指定的整个数据库（下面例子为 system 用户名，密码是 123456 的情况）。 $ /opt/Kingbase/ES/V9/Server/bin/exp system/123456@kingbase full=y file=full.dmp Export terminated successfully without warnings. 4.1.2 用户模式导出 用户模式会导出指定模式下的数据库对象和内容（下面例子为 alice 用户名，密码是 123456 的情况）。 $ /opt/Kingbase/ES/V9/Server/bin/exp alice/123456@kingbase owner=alice file=alice.dmp Export terminated successfully without warnings. 4.1.3 表模式导出 表模式会导出指定的表模式或表内容（下面例子为 system 用户名，密码是 123456 的情况）。 10 第 4 章 功能与实践 $ /opt/Kingbase/ES/V9/Server/bin/exp system/123456@kingbase tables=public.t1,public.t2,alice.t3 file=tables. dmp Export terminated successfully without warnings. 4.2 imp 功能与实践 imp 支持完全模式、表模式、用户模式的导入功能，相关参数详细说明请参见附录 B：imp 导入参数说明 。 4.2.1 完全模式导入 完全模式会将指定 dmp 文件内容全部导入到数据库中（下面例子为 system 用户名，密码是 123456 的情况）。 $ /opt/Kingbase/ES/V9/Server/bin/imp system/123456@kingbase full=y file=full.dmp Import terminated successfully without warnings. 4.2.2 用户模式导入 用户模式会将指定模式内的数据库对象和内容导入到另一个指定的用户模式中（下面例子为 system 用户名，密 码是 123456 的情况）。 $ /opt/Kingbase/ES/V9/Server/bin/imp system/123456@kingbase fromuser=public touser=alice file=full.dmp Import terminated successfully without warnings. 4.2.3 表模式导入 表模式会将指定的表导入到数据库中（下面例子为 system 用户名，密码是 123456，导入 alice 模式的 t3 表的情 况）。 $ /opt/Kingbase/ES/V9/Server/bin/imp system/123456@kingbase tables=t3 fromuser=alice file=full.dmp ignore=y Import terminated successfully with 1 warnings. 11 第5章 5 第 章 附录 A：EXP 导出参数说明 附录 A：exp 导出参数说明 exp 导出指定的数据库到 dmp 文件中，使用方法如下： exp [OPTION]... [OPTION]: KEYWORD=value or KEYWORD=(value1,value2,…,valueN) 5.1 USERID [USERID=]user/pwd@servicesname USERID 参数用 user/pwd@servicesname 的形式指明了连接到数据库的参数，用户名、密码，以及配置文件中 预置的 servicename，和 oracle 的使用方式保持了一致；同时，也支持独立的链接参数，使用 host、port、dbname、 user、password 参数来实现同样的使用效果。该参数为必须项。 注意: user/pwd@servicesname、host=ip、port=123、dbname=db 这些参数共用时，host、port、dbname 参数将 被忽略，只使用 servicesname 内指定的 host、port、dbname。 注意: 使用 user/pwd@servicesname 形式时，同时也使用了 user、password 参数，那么后面的值会覆盖前面的值， 即实际生效的参数值是后面的。 12 第5章 USERID 示例 附录 A：EXP 导出参数说明 说明 USERID=kingbase/kingbase@kingbase kingbase/kingbase@kingbase host=192.168.45.162 port=54323 dbname=test user=kingbase password=kingbase kingbase/kingbase@kingbase host=host1 port=54321 dbname=tb1 host=host1 port=54321 dbname=tb1 将 被忽略 kingbase/kingbase@kingbase user=kb2 实际使用的用户名为 kb2 password=pwdx kingbase/kingbase@kingbase 实际使用的密码为 kingbase 5.2 OWNER OWNER=(value1,...,valueN) 指明了需要导出的用户名（模式名），可导出多个模式；如果选用了该模式，则无法和表模式、全量模式共用。 OWNER 示例 说明 OWNER=public 导出 public 模式数据 OWNER=”(kingbase,public)” 导出 kingbase、public 两个模式的数据 5.3 TABLES TABLES=(value1,...,valueN) 指明了需要导出的表名，可以导出多个表；其中表名可以写成正则表达式的形式，导出时会做正则匹配，将匹配 到的表都导出；如果选用了该模式，则无法和用户模式、全量模式共用。 注 意: 如 果 参 数 值 中 未 加 模 式， 即 tables=t， 就 会 去 该 用 户 的 模 式 下 查 找 表 并 导 出， 作 用 等 同 于 ta- bles=username.t。 13 第5章 TABLES 示例 附录 A：EXP 导出参数说明 说明 tables=public.t1 tables=public.t1,public.t2 tables=”(public.t1,public.t2)” tables=public.’”aaAA~!@#$%^&*()123”’ 适用 Linux 平台，对于包含特殊字符的表名，可参照此例处理 tables=public.’aa*123’ 适用 Linux 平台 tables=”(public.”’”aaAA~!@#$%^&*()123”’”)” 适用 Linux 平台，对于包含特殊字符的表名，可参照此例处理 tables=”(public.’aa*123’)” 适用 Linux 平台 注意: 尽量避免使用表模式导出带有特殊字符的表，因为需要对特殊符号做转义，或者借助正则表达式的形式 （aaAA*123）来唯一匹配到带特殊字符的表（aaAA~!@#$%^&*()123）。 注意: # 会被当作命令的注释开头，所以表名中带有 # 需要使用双引号或者单引号引起来。 5.4 ROWS ROWS=y/n 默认是 y ROWS=n 时，只导出数据库对象的定义，不导出具体数据，不能和 QUERY 参数共用 ROWS=y 时，使用 COPY 导出 注意: 若设为 n，物化视图的刷新操作不会被导出，导入后需要手动刷新物化视图，否则会报错并提示未初始化。 ROWS 示例 ROWS=y ROWS=n 14 第5章 附录 A：EXP 导出参数说明 5.5 FULL FULL=y/n 全量导出模式，如果选用了该模式，则无法和表模式、用户模式共用。默认值为 n。 FULL 示例 FULL=y FULL=n 5.6 FILE FILE=filename 指定导出的 dmp 文件名，可以带路径，不指定路径即在当前路径下生成 dmp 文件，注意 exp 程序只能导出数据 库到一个文件中。该参数为必须项。 FILE 示例 说明 FILE=db.dmp FILE=/tmp/db.dmp Linux 平台带路径的设置 FILE=c:\tables.dmp Windows 平台也可以使用全路径 5.7 PARFILE PARFILE=filename 指定包含 exp 参数的文件名，exp 程序会读取该文件并加载里面的参数。 注意: 文件内的参数必须以空格或者换行间隔。 15 第5章 PARFILE 示例 说明 PARFILE=parameters.conf cat parameters.conf 附录 A：EXP 导出参数说明 kingbase/kingbase@kingbase LOG=logfile FULL=y 或者 kingbase/kingbase@kingbase LOG=logfile FULL=y 5.8 LOG LOG=logfilename 指定日志文件名，exp 程序会将所有日志输出写入到该文件中。 LOG 示例 说明 LOG=exp.log LOG=/tmp/exp.log Linux 平台带路径的设置 LOG=c:\exp.log Windows 平台也可以使用全路径 5.9 QUERY QUERY=whereclause 该参数仅在表模式下有效，exp 会导出 QUERY 参数指定的 where 条件限定的表的子集。该参数只能配置一个， 若配置多个 QUERY 参数，那么只有最后一个 QUERY 参数生效。 注意: Windows 平台需要转义。 16 第5章 附录 A：EXP 导出参数说明 QUERY 示例 说明 TABLES=public.t 理解为 select * from public.t TABLES=public.t QUERY=”where id > 10” 理解为 select * from pub- lic.t where id > 10 Windows 平台需要特殊的转义 TABLES=public.t QUERY=”’where id > 10’” 或者 TABLES=public.t QUERY=’”where id > 10”’ 5.10 CONSTRAINTS CONSTRAINTS=y/n 指示 exp 程序是否导出约束，默认值为 y。 注意: 非空约束不受该参数限制。 注意: 若设为 y，普通表的主键约束会变为非空约束。 5.11 INDEXES INDEXES=y/n 指示 exp 程序是否导出索引，默认值为 y。 INDEXES 示例 INDEXES=y INDEXES=n 17 第5章 附录 A：EXP 导出参数说明 5.12 TRIGGERS TRIGGERS=y/n 指示 exp 程序是否导出触发器，默认值为 y。 TRIGGERS 示例 TRIGGERS=y TRIGGERS=n 5.13 KEY KEY=encryptkey 设定 exp 程序加密 dmp 文件的密钥，密钥长度限制为 1~16 字节，不设置该参数则不加密。 KEY 示例 KEY=’123;434’ KEY=’ 好费 21a 你和’ 5.14 -? 或--help -?, --help show this help, then exit 输出帮助信息并退出。 5.15 -V 或--version -V, --version output version information, then exit 输出版本信息并退出。 18 第 6 章 附录 B：IMP 导入参数说明 6 第 章 附录 B：imp 导入参数说明 imp 从 dmp 文件导入数据库，使用方法如下： Usage: imp [OPTION]… [OPTION]: KEYWORD=value or KEYWORD=(value1,value2,…,valueN) 6.1 USERID [USERID=]user/pwd@servicesname 和 exp 程序的 USERID 参数完全一致，不再赘述。 6.2 FROMUSER FROMUSER=(value1,...,valueN) 指定了 imp 导入程序要导入的模式数据（多值以逗号分隔），必须与 TOUSER 参数一起使用形成 imp 的用户 模式导入方式。 注意: 1. FROMUSER 的模式个数必须与 TOUSER 的模式个数一致；或者 FROMUSER 模式有多个，TOUSER 模式只 有一个（即多个模式恢复到一个模式中）。 2. FROMUSER、TOUSER 形成的用户模式，不可以和其他模式（表模式、全量模式）一起使用。 19 第 6 章 附录 B：IMP 导入参数说明 3. 必须确保目标库内存在 TOUSER 参数指定的模式，imp 程序不会创建 TOUSER 指定的模式本身（不执行 create schema 语句）。 4. 只有当 FROMUSER 下的表的 owner 是 FROMUSER 的值时，才会将表的 owner 改为 TOUSER 的值，并且 要求 TOUSER 的值是真实的数据库用户。 5. 当 FROMUSER=public TOUSER=xx 时，public 模式下的同义词不做模式转换。 6. 不支持 FROMUSER 为 1 个模式，TOUSER 为多个模式的情况。 7. FROMUSER 的值默认是大小写不敏感的，可通过 FROMUSERCASESENSITIVE=y 来设置为敏感。 FROMUSER 示例 说明 FROMUSER=public 将 dmp 文件中 public 模式的数据，改为 kingbase 后执行 TOUSER=kingbase 比如 dmp 文件中的 CREATE TABLE public.t ( .... 被更改成 CREATE TABLE kingbase.t (... FROMUSER=A,B,C 两个参数的模式个数必须相同，这个示例的意思是将模式 A、B、C 中的对象，分别恢 TOUSER=D,E,F 复到 D、E、F 模式中，按照指定顺序一一对应 FROMUSER=A,B,C A、B、C 这三个模式的对象全部恢复到 D 模式中 TOUSER=D FROMUSER=” (A,B)” Linux 平台下，多个模式可以使用括号，但必须加引号，但会涉及到特殊符号的转义问 TOUSER=’(C)’ 题 注意：Windows 平台下，不能使用这种方式 6.3 FROMUSERCASESENSITIVE FROMUSERCASESENSITIVE=y/n 默认为 n，即 FROMUSER 参数值大小写不敏感，详见 FROMUSER 参数的解释。 6.4 TOUSER TOUSER=(value1,...,valueN) 详见 FROMUSER 参数的解释。 20 第 6 章 附录 B：IMP 导入参数说明 6.5 TABLES TABLES=(value1,...,valueN) 指示 imp 程序要导入的表名。 注意: 1. 表名不支持正则表达式。 2. 不支持导入指定的某个分区表。 3. 只能使用表名，表名前面不可以加模式名称，但多个模式下的同名表，全部都会被导入。 4. 若要导入指定模式下的某几个表，使用 fromuser=kingbase tables=tables_name,table_name1 形式。 5. 使用表模式导入时，目标库中必须有要导入的表所依赖的模式。 6. 表名需要使用小写。 7. 若指定导入的分区子表上有 sequence 依赖分区父表，则也需要指定导入该 sequence，否则创建分区子表失败。 8. 指定表导入只会恢复指定表的定义，而不会恢复它依赖的其他的数据库对象。 TABLES 示例 TABLES=table1,table2 tables=t1,t2 fromuser=kingbase 6.6 ROWS ROWS=y/n 指示 imp 程序是否执行表数据的插入操作，默认值为 y。 ROWS 示例 ROWS=y ROWS=n 21 第 6 章 附录 B：IMP 导入参数说明 6.7 FULL FULL=y/n 指示 imp 程序导入完整的数据库 dmp 文件，默认值为 n。该全量模式不能和其他模式共用。 注意: 使用时请留意导入用户的权限，若 dmp 文件有多个模式，导入用户是普通用户就没有创建模式的权限，就只 会导入 public 模式的数据库对象。 注意: 用户模式导出的 dmp 文件，若使用全量模式做导入，因该模式会去创建模式，所以可能会遇到 public 等模式 已经存在的错误，添加 ignore=y 参数即可忽略错误继续做导入操作。 FULL 示例 FULL=y FULL=n 6.8 IGNORE IGNORE=y/n 指示 imp 程序导入过程中出错时的行为，是忽略错误继续执行导入，还是遇到错误直接退出，默认值为 n。 IGNORE 示例 IGNORE=y IGNORE=n 6.9 FILE FILE=filename 指示 imp 程序要导入的 dmp 文件的文件名，该参数为必须项。 22 第 6 章 附录 B：IMP 导入参数说明 注意: 只能指定一个 dmp 文件名，不支持同时导入多个 dmp 文件。 FILE 示例 说明 FILE=db.dmp FILE=/tmp/db.dmp Linux 平台带路径的设置 FILE=c:\tables.dmp Windows 平台也可以使用全路径 6.10 PARFILE PARFILE=filename 与 exp 的 PARFILE 参数完全一致，不再赘述。 6.11 LOG LOG=logfilename 与 exp 的 LOG 参数完全一致，不再赘述。 6.12 CLEAN CLEAN=y/n 指示 imp 程序先删掉数据库对象，再执行导入操作，默认值为 n。 CLEAN 示例 CLEAN=y CLEAN=n 23 第 6 章 附录 B：IMP 导入参数说明 6.13 ONLYVIEW ONLYVIEW=y/n 指示 imp 程序只导入视图对象，默认值为 n。 注意: 源库数据存在多个模式，各个模式中都有视图时，要求目标库中也需要有 dmp 文件中视图所依赖的模式。 ONLYVIEW 示例 ONLYVIEW=y ONLYVIEW=n 6.14 RECREATEVIEW RECREATEVIEW=y/n 指示 imp 程序在导入的最后阶段先删掉所有视图，再重新创建它们，默认值为 n。 RECREATEVIEW 示例 RECREATEVIEW=y RECREATEVIEW=n 6.15 KEY KEY=decryptkey 设定 imp 程序解密 dmp 文件的密钥，密钥长度限制为 1~16 字节，必须和 exp 导出 dmp 文件时设置的密钥一样 才能正确解密，不设置该参数则不解密。 24 第 6 章 附录 B：IMP 导入参数说明 KEY 示例 KEY=’123;434’ KEY=’ 好费 21a 你和’ 6.16 -? 或--help -?, --help show this help, then exit 输出帮助信息。 6.17 -V 或--version -V, --version output version information, then exit 输出版本信息。 25 版权声明 版权声明 北京人大金仓信息技术股份有限公司（简称：人大金仓）版权所有，并保留对本手册及本声明的一切权利。 未得到人大金仓的书面许可，任何人不得以任何方式或形式对本手册内的任何部分进行复制、摘录、备份、修 改、传播、翻译成其他语言、将其全部或部分用于商业用途。 免责声明 本手册内容依据现有信息制作，由于产品版本升级或其他原因，其内容有可能变更。人大金仓保留在没有任何通 知或者提示的情况下对手册内容进行修改的权利。 本手册仅作为使用指导，人大金仓在编写本手册时已尽力保证其内容准确可靠，但并不确保手册内容完全没有错 误或遗漏，本手册中的所有信息也不构成任何明示或暗示的担保。 技术支持 • 人大金仓官方网站：http://www.kingbase.com.cn/ • 人大金仓文档中心：http://help.kingbase.com.cn/ • 全国服务热线：400-601-1188 • 人大金仓技术支持与反馈信箱：support@kingbase.com.cn 26 服务周期承诺 服务周期承诺 由于市场需求在不断变化，技术创新和发展的进程不断加剧，产品的版本更迭不可避免。人大金仓对于产品版本 生命周期的有效管理，有助于您提前规划项目，更好地从产品服务终止上过渡。 表 1: KingbaseES 产品生命周期里程碑 关键里程碑点 定义 产品发布日期 产品正式发布版本，即 GA（general availability）版本的发布日期。 停止销售日期 正式停止销售的日期，版本停止接受订单日。该日之后，产品将不再销售。 停止功能升级日期 在该日期之后，不再提供新特性和新硬件支持。但依旧提供错误修复、安全修复、功 能维护等服务。 停止功能维护日期 在该日期之后，不再维护功能，修复问题。但依旧提供安全修复等服务 停止安全维护日期 在该日期之后，不再发布补丁版本修复中高风险漏洞，仅提供有限的支持。 产品服务终止日期 停止提供产品服务和支持的日期。包括软件维护版本，缺陷修复，以及针对该产品的 所有服务支持（包括服务热线和远程/现场支持）。 服务周期策略 金仓数据库管理系统 KingbaseES 产品确保以下的服务周期： 1）产品自发布之日起至产品停止功能升级（包含新特性、新硬件支持）之日不少于 5 年。 2）产品停止功能升级之日起至产品停止功能维护（主要包括问题修复）之日不少于 4 年。 3）产品功能维护停止之日起至产品停止安全维护（包括中高风险漏洞修复）之日不少于 2 年。 服务终止策略 金仓数据库管理系统 KingbaseES 产品确保在销售后，至少提供 6 年的服务支持。 注意: 人大金仓将会综合各方因素来确定产品服务终止日期。并将在实际产品服务终止日期之前至少 90 天，通过公 27 服务周期承诺 开方式宣布产品服务终止日期。 28