migrate 命令

术语迁移描述了通过表示外部数据的方法来获取位于 Rational® Synergy 数据库外部的数据并在 Rational Synergy 数据库中创建该数据的过程。

例如,您可能在某个文件系统位置具有某个目录组织中的文件,并且希望在 Rational Synergy 数据库中创建表示该数据的项目、目录和文件。

在 Rational Synergy 中,迁移分两个单独阶段来执行:
  1. 使用 ccm migrate 命令来创建描述要创建的数据的导入数据包。
  2. 使用 ccm import 命令来导入上一步中创建的数据并在 Rational Synergy 数据库中创建对象。

    此两阶段方法的优点在于,如果您要迁移几个单独的应用程序或组件,可以对各项执行第一步。然后,可以在以后(例如夜间)执行更耗时的导入所有数据包的操作。

ccm migrate 操作包含两种类型的迁移:
  • 完全迁移,这样生成的新项目集包含表示要迁移的数据的目录和文件新实例。生成的导入数据包表示要迁移的所有对象。
  • 增量迁移,它仅使用为与要迁移的数据匹配所需的更改来更新现有项目层次结构。现有项目层次结构用作参考来确定更改。生成的导入数据包表示与参考项目层次结构相比新增、更改或除去的对象。
如果您具有要迁移的应用程序的几个发布标识,以下是典型的使用模式:
  1. 对第一个发布标识执行完全迁移和导入,从而创建表示该发布标识的项目层次结构。
  2. 执行复制项目操作来为下一个发布标识创建项目版本。
  3. 对下一个发布标识执行增量迁移并将其导入到上一步创建的现有项目中。继续到下一个发布标识之前必须执行导入,以确保您具有正确的更改历史记录。
  4. 根据需要为每个后续发布标识重复步骤 2 和 3。

ccm migrate 操作使用映射规则来确定要处理或忽略的文件。该操作还使用映射规则来确定对象属性,包括其 Rational Synergy 类型。许多映射规则都由类型定义上的数据进行确定。例如,如果 java 类型定义与 .java 的后缀匹配模式关联,那么要使用 ContextFactory.java 之类的名称来迁移的文件通常由 java 类型的 Rational Synergy 对象表示。

预览和显示有关迁移的信息

ccm migrate 命令支持在不创建导入数据包的情况下或在创建导入数据包的同时将对象详细信息显示为预览。您可以使用标准格式化选项来指定显示的数据内容和表示格式。

可以在迁移格式字符串中显示两种类型的数据:
  • 特殊迁移属性。
  • 导入后与 Rational Synergy 属性对应的迁移属性。

支持以下特殊迁移属性关键字:

表 1. 特殊迁移属性关键字
属性名 描述
ACTION
所执行的迁移操作的类型:
  • 新建

    创建了对象的实例。

  • 修改日期

    通过检出新版本修改了现有对象。

  • 已忽略

    忽略了新对象。

  • 已删除

    由于源路径中缺少某个现有对象或者迁移规则将其忽略,因此从项目中除去了该对象。

  • 未更改

    未更改现有对象。

INDENTED_NAME 对象的名称加上由零个、一个或多个前导空格构成的前缀。前导空格数由相对于顶级项目的目录嵌套的缩进级别来确定。
SOURCE_PATH 所迁移的源对象的绝对路径。
RELATIVE_PATH 所迁移的源对象相对于顶级项目的相对路径。

不是其中某种特殊情况的任何属性名都将视为迁移对象的属性。在大多数情况下,导入对象时将创建一个 Rational Synergy 属性。例如,导入数据后,name 属性 (property) 与 name 属性 (attribute) 对应。

migrate 命令支持以下子命令:


反馈