workbench extension source import 命令

使用 istool 命令 workbench extension source import 可将扩展数据源从逗号分隔值 (CSV) 格式的文件导入元数据存储库。

用途

要导入扩展数据源或要安排导入时，可以使用此命令。

需求

您必须具有 Information Governance Catalog 信息资产管理员角色。

必须在相同的 IBM® WebSphere® Application Server 上安装 Information Governance Catalog。

istool 命令框架的版本必须与 InfoSphere® Information Governance Catalog 的版本相同。

从客户机层运行该命令，如果 InfoSphere Information Governance Catalog 是安装在引擎层，请从引擎层运行该命令。

命令语法

运行此命令的首选方式是 istool 命令行窗口。如果在操作系统命令行窗口中或脚本中运行此命令，那么必须在命令名前添加 istool。

istool> workbench extension source import
authentication parameters
-filename import_file 
-output log_file_name
[-overwrite] true_or_false
[generic parameters]

参数

这些参数特定于 workbench extension source import 命令。 有关认证参数和通用参数，请参阅常见命令和参数。

-filename | -f import_file
指定包含要导入元数据存储库的扩展数据源对象的文件的名称和目录路径。 对于扩展数据源，该文件必须采用 CSV 格式。
您也可以指定目录名称以导入该目录中的所有 CSV 文件。
-output | -o log_file_name
指定包含已运行命令的输出（包括错误）的日志文件的名称。在 log_file_name 中包含目录路径。
如果目录不存在，那么命令将失败。
如果该日志文件不存在，那么将创建该文件。如果该日志文件存在，那么会将输出追加到该文件的末尾。如果命令在不同时间自动运行，那么日志文件将显示已运行的每个命令的即时输出。
-overwrite | -ov true_or_false
缺省情况下，值为 true 且导入将覆盖元数据存储库中的扩展数据源对象。如果值为 false，那么保留元数据存储库中的现有扩展数据源对象。

导入多种类型的资产

归档文件可以包含来自多个工具的多个导出的资产。要获取最佳性能，在从归档文件导入时，或者迁移多个归档文件中不同类型的资产时，请运行单独的命令来按以下顺序导入以下类型的资产：
  1. 使用 -sec 选项导入用户和组。
  2. 使用 -cm 选项导入公共元数据。将 -lm 选项用于逻辑模型。
  3. 使用 -ds 选项导入 InfoSphere DataStage® and QualityStage® 项目。
  4. 使用 -rep 和 -replace 选项导入报告。
  5. 使用 -ia 选项导入 IBM InfoSphere Information Analyzer 项目。
  6. 使用 -fasttrack 选项导入 IBM InfoSphere FastTrack 资产。
  7. 使用相应的 -type 选项导入 InfoSphere Information Governance Catalog 扩展数据源资产。 在 11.3 之前的版本中，这些资产由 IBM InfoSphere Metadata Workbench 创建。
  8. 使用 -overwrite 选项导入扩展映射文档中的 InfoSphere Information Governance Catalog 扩展映射。在 11.3 之前的版本中，这些资产由 InfoSphere Metadata Workbench 创建。
  9. 使用相应的 -mergemethod 选项导入 InfoSphere Information Governance Catalog 词汇表资产。 在 11.3 之前的版本中，这些资产由 InfoSphere Business Glossary 创建。
  10. 导入扩展数据源和扩展映射的定制属性：
    • 从 InfoSphere Information Governance Catalog 中的管理 > 目录管理 > 定制属性导入定制属性。 在 11.3 之前的版本中，这些资产由 InfoSphere Metadata Workbench 创建。
    • 从 InfoSphere Information Governance Catalog 中的目录 > 信息资产 > 管理 > 导入定制属性值导入定制属性值。 在 11.3 之前的版本中，这些资产由 InfoSphere Metadata Workbench 创建。

对于扩展数据源，workbench extension source import 命令会将定制属性值（而不是定制属性）导入元数据存储库。在运行 workbench extension source import 命令之前，必须在 InfoSphere Information Governance Catalog 的管理选项卡上导入定制属性。

如果扩展数据源资产已根据主要类型（Application、StoredProcedure 和 File）导出到不同的导出文件中，那么在导入期间，将保留扩展数据源资产的正确层次结构。因此，您可以按照任意顺序导入这些导出文件。但是，如果按照主要类型的成员（例如，ResultColumn）导出了扩展数据源，那么必须使用以下顺序进行导入：
应用程序
  1. ObjectType
  2. 方法
  3. 顺序不重要：InputParameter、OutputValue
StoredProcedure
顺序不重要：InParameter、OutParameter、InOutParameter、ResultColumn

输出

返回值 0 表示成功完成；其他任何值都表示失败。失败的原因在屏幕消息中显示。

有关更多信息，请参阅以下任一目录中的系统日志文件：
对于 Microsoft Windows 操作系统环境
C:\Documents and Settings\username\istool_workspace\.metadata\.log
其中，username 是运行此命令的用户的操作系统帐户名称。
对于 UNIX 或 Linux 操作系统环境
user_home/username/istool_workspace/.metadata/.log
其中，user_home 是所有用户帐户的根目录，而 username 是运行此命令的用户的操作系统帐户名称。

示例

示例 1：导入主要类型的扩展数据源

您要从 E:\CLI\files 目录中的 CSV 文件导入扩展数据源。 CSV 文件是以下三种主要类型的扩展数据源资产的导出文件：Application、StoredProcedure 和 File。日志文件为 C:\IBM\InformationServer\logs\EDS_all_import.log。 您可以使用以下命令导入目录中的所有三个 CSV 文件：
istool> workbench extension source import 
-f E:\CLI\files 
-o C:\IBM\InformationServer\logs\EDS_all_import.log
-dom mysys
-u myid -p mypassword

在此情况下，因为每个 CSV 导入文件都具有一种主要类型的扩展数据源，所以导入顺序不重要。

示例 2：导入一种主要类型的扩展数据源的成员

您要导入 ResultColumn，这是类型为 StoredProcedure 的扩展数据源资产成员。如果目标存储库中没有 StoredProcedure，那么首先必须导入 StoredProcedure。然后，导入 ResultColumn，它位于名为 ResultColumn_for_import.csv 的 CSV 文件中：
istool> workbench extension source import 
-f E:\CLI\files\ResultColumn_for_import 
-o C:\IBM\InformationServer\logs\ResultColumn_import.log
-dom mysys
-u myid -p mypassword
父主题： 扩展数据源命令
相关信息:
使用 istool 命令行
命令和公共参数
扩展数据源
要导入定制属性值的 CSV 文件格式
要导入定制属性值的 CSV 文件格式