1 业务场景

1.1 场景描述

使用地址管理特性一段时间以后，国际化地址库中可能会积累越来越多“无用”的地址数据，例如：

• 未来业务不再使用的地址数据；

• 由于行政区划变更撤销或地名变更等原因所导致的失效地址数据。

这些“无用”的地址数据，不仅会浪费存储空间，也可能导致需要查询和更新国际化地址库数据的单据、报表和其他应用程序性能下降。 为了预防或解决这个问题，可以使用地址数据归档解决方案。

地址管理特性，请参考：地址管理设置。

2 解决方案

利用苍穹平台数据归档通用功能，把已经完结的、不常用的地址数据转移到独立的存储(数据库)中。

3 操作步骤

3.1 归档前置准备

• 数据归档总开关archive.enable=true，默认关闭。需要在MC中配置发布，苍穹需重启；

• MC中配置归档路由并发布，苍穹无需重启；

3.2 归档配置操作步骤

3.2.1 新建归档库

配置归档数据目标存储库。

3.2.2 配置单据归档范围

注：非“日志”类型的表单无法开启“允许被归档清除”。

3.2.3 配置归档索引

配置归档库索引字段。归档地址数据查询时，单据中通常需要根据“id”、“number”、“name”、“countryid”等字段信息进行过滤，可以通过配置该类型字段为索引来提高归档数据查询性能。

3.2.4 配置归档规则

配置数据迁移的抽取条件规则，条件类型支持“单据”和“自定义”。配置时会自动带出引用的同库基础资料，在数据迁移时可以将同库基础资料数据一并同步到归档库，用于归档库执行关联查询。

1.单据类型：如按业务日期范围可以归档上月、上季度、去年，以及自定义日期范围内的地址数据。

2.自定义类型：需要注册归档插件。可以通过插件实现无法配置的归档规则，比如：未归档的数量在一定量级（如200w条），超过时自动归档。自定义插件必须实现归档插件类：kd.bos.archive.framework.plugin.EntityArchivePlugin 并实现查询ID的迭代器。示例代码如下：

3.2.5 配置归档调度计划

配置归档规则执行的时间计划。可以设置计划执行开始时间，重复事件按分钟、小时、星期、月等单位，且支持自定义cron表达式。

3.2.6 归档监控

可以通过以下配置入口查看归档监控：【配置工具】→【数据归档】→【归档监控】。

支持以下归档监控功能：

• 调度任务：可查看归档/反归档的调度任务，并对失败的任务进行重试操作。 

• 已归档单据（反归档）：可查看已归档的单据/基础资料，并对已归档的数据进行反归档操作。 

• 迁移信息（中间表）：可查看归档调度任务过程中生成的备份表名，并对表进行清除操作。 

• 任务日志：记录归档迁移日志，可用于查询迁移过程中出现的异常信息等。

3.2.7 查询归档地址数据

方法一：在地址基础资料列表会自动显示归档库下拉框，只需要选择对应归档库，即可查询归档数据。

方法二：通过数据归档API、查询时设置归档路由并映射上下文，代码示例：