您可以通过导出工件创建的 ZIP 文件从IBM Knowledge Catalog实例导入所有治理工件。
您可以使用此方法将治理工件从一个IBM Knowledge Catalog实例移动到另一个实例，或使用外部工具编辑治理工件属性。 将在没有工作流程的情况下立即发布所有导入的工件。
先决条件
在使用 ZIP 文件导入监管工件之前，请创建格式正确的文件，并确保您具有必需的许可权。
ZIP 文件
您必须具有通过 GET /v3/governance_artifact_types/{artifact_type}/export API 请求创建的导出工件的 ZIP 文件。 ZIP 文件的最大大小为 2 GB。 请参阅 将所有监管工件导出到 ZIP 文件。
许可权
您必须具有 管理词汇表 用户许可权。
您无需是导入过程所创建或影响的任何类别中的合作者。
编辑 ZIP 文件的内容
导出的 ZIP 文件包含每个工件类型的单独文件夹，其中包含包含该工件类型的 CSV 文件。
您可以手动修改导出的 ZIP 文件的内容。 遵循以下准则：
- 请勿创建其他文件夹，例如，父文件夹。
- 请勿更改文件夹名称。 ZIP 文件中每种工件类型的文件夹必须具有以下名称:
category，classification，data_class，glossary_term，policy，rule和reference_data。 - 保持每个 CSV 文件的正确格式。 请参阅 用于导入监管工件的 CSV 文件格式。
- 请勿除去或重命名每个 CSV 文件中的
Artifact ID列。 此列指定工件的标识以及工件的名称。 - 仅为其中一个工件定义两个监管工件之间的关系。 有两个例外:
- 此关系是策略与监管规则之间的关系。 在这种情况下，请在两个 CSV 文件中定义这两个工件的关系。 在包含策略的 CSV 文件中，在
Rule列中添加关系。 在包含监管规则的 CSV 文件中，在Parent Policies列中添加关系。 - 您正在使用
all合并选项。 在这种情况下，您必须确保所有 CSV 内容在工件之间的关系方面一致。 例如，如果 ZIP 导入文件同时包含术语和与关系连接的数据类，那么此关系必须同时存在于数据类 CSV 和术语 CSV 中。 否则，关系导入行为不可预测，可以导入关系，也可以不导入关系。
- 此关系是策略与监管规则之间的关系。 在这种情况下，请在两个 CSV 文件中定义这两个工件的关系。 在包含策略的 CSV 文件中，在
准备导入 ZIP 文件
在导入 ZIP 文件之前，必须完成以下任务:
- 执行相应的操作以避免重复的预定义工件
- 创建任何定制属性和关系
避免重复的预定义工件
导出的 ZIP 文件中的工件通过 Artifact ID 列中的工件标识进行标识，而不是通过工件名称和类别路径进行标识。 但是，每个IBM Knowledge Catalog实例的预定义业务术语、数据类和分类的工件标识符是不同的。 因此，导入的预定义业务术语，数据类和分类无法识别为与现有预定义业务术语，数据类和分类相同。 因此，导入过程将创建重复工件。
您可以使用下列其中一种方法来避免重复的预罚款工件:
在导入工件之前，从目标IBM Knowledge Catalog实例中删除现有的预定义工件。 请参阅 删除相同类型的已发布工件。
对于预定义的数据类和分类:
- 通过导出工件创建 ZIP 文件时，排除 [uncategory] 类别。
- 编辑数据类和分类的 CSV 文件，并将 父分类 和 父数据类 列中预定义数据类和分类的工件标识替换为等效的预定义工件名称和类别路径。
- 编辑其他工件的 CSV 文件，并将预定义数据类和分类的工件标识替换为与预定义工件具有关系的任何工件的 分类 和 数据类 列中的等效预定义工件名称和类别路径。
导入工件时，将创建与现有目标预定义工件的关系。
对于预定义的业务术语:
- 通过导出工件创建 ZIP 文件时，排除 Knowledge Accelerator 样本个人数据 类别。
- 编辑 Business termsa 和其他工件的 CSV 文件，并将预定义业务术语的工件标识替换为 相关术语 列和定义业务术语关系的任何其他列中的等效预定义工件名称和类别路径。
导入工件时，将创建与现有目标预定义工件的关系。
位置类别中的预定义参考数据集在所有IBM Knowledge Catalog实例中都具有相同的工件 ID 值。
创建定制属性和关系
在导入 ZIP 文件之前，必须手动创建每个定制属性或关系定义。 否则，不会导入定制属性和关系值。
有关更多信息，请参阅 定制属性和关系。
合并选项
运行 ZIP 导入时，以下合并选项可用:
all- 替换所有值。 导入的值将替换目录中的现有值。
specified- 替换为定义的值。 导入的非空值将替换目录中的现有值。
empty- 替换空值。 导入的值仅替换目录中的空值。
specified 用作缺省值。
导入包含参考数据值的文件时，必须始终使用 merge_option=all。
有关合并选项的更多信息，请参阅 用于合并已导入工件和现有工件的方法
导入 ZIP 文件
要导入监管工件的 ZIP 文件，请执行以下操作:
- 如果需要，请删除现有预定义工件或编辑与预定义工件的关系。 请参阅 准备导入 ZIP 文件。
- 提交
POST /v3/governance_artifact_types/import请求。 包含合并选项和 ZIP 文件的路径。 请参阅 API 文档: 从指定的 ZIP 文件导入值。 将在没有工作流程的情况下立即发布所有工件。 - 导入过程完成后，将其他合作者添加到新类别。 请参阅 管理类别合作者。
您必须等待导入过程完成，或者 清除停滞的过程，然后才能启动新的导入过程。
监视导入过程
提交导入 ZIP 文件的请求后，将在响应中提供进程标识 (process_id 参数)。 您可以使用进程标识来检查导入的状态。 提交 GET /v3/governance_artifact_types/import/status/{process_id} 请求以查询导入状态。 请参见API 文档：导入状态。
清除停滞的导入过程
试验性 这是试验性发行版，尚不支持在生产环境中使用。
如果导入停滞，那么可以清除导入过程，然后再次导入 ZIP 文件。 在前一个导入过程完成或清除已停止的过程之前，无法启动新的导入过程。 在 24 小时处于不活动状态后，将自动清除所有导入过程。
您可以通过提交 GET /v3/governance_artifact_types/import/status/{process_id} 请求来检查导入过程的状态。 如果状态为 IN_PROGRESS ，但未导入工件，那么进程将停止。
要清除已停止或失败的导入过程，请提交 POST /v3/governance_artifact_types/import/cleanup/{process_id} 请求。
了解更多信息
父主题: 管理工件的导入方法