并集创建器处理器用于生成事件记录相关几何与作为地理围栏导入的一个或多个几何之间的几何并集。
示例
以下是并集创建器处理器的用例:
- 该处理器可以使用与事件记录相交的地理围栏来增强事件记录的几何。 几何并集可用于后处理工作流,以指示发生事件的地理围栏(或区域)的覆盖范围。
- 处理器可用于根据点事件的实时观察来创建多点要素。 可以将入站事件发送到要素服务以存储为地理围栏。 同时,收到的每个新的点事件都可以与地理围栏合并为先前的观测值。 生成的几何为多点要素,用于将当前点事件观测值与先前的地理围栏事件观测值的近实时集合相结合。
用法说明
使用并集创建器处理器时,请记住以下事项:
- 并集创建器处理器使用事件记录的几何图形以及注册为地理围栏的一个或多个几何图形。 例如,正则表达式可用于指定几个不同的地理围栏以确定并集。
- 该处理器需要指定包含几何的事件记录字段。 可以指定几何字段名称,也可以将 GEOMETRY 标签应用于 GeoEvent 定义中的字段,以标识几何字段。
- 可以对处理器进行配置以将事件记录的几何替换为指定几何并集,或者使用替换几何参数将并集放入新几何字段中。 向 GeoEvent 添加新字段将更改事件记录方案,这需要 GeoEvent Server 创建一个新的 GeoEvent 定义。 新的 GeoEvent 定义将由 GeoEvent Server 管理,并且如果处理器或者使用该处理器的 GeoEvent 服务发生改变,则该定义将被删除。
- 差集创建器处理器和对称差集创建器处理器等其他处理器仅可以处理两个离散几何,但并集创建器处理器接受正则表达式,允许指定若干个地理围栏。 因此,可以使用已导入为地理围栏的一个或多个几何来获取接收到的事件记录几何的并集。
参数
以下是并集创建器处理器的参数:
参数 | 描述 |
---|---|
名称 |
用于在 GeoEvent Manager 中引用的处理器的描述性名称。 |
处理器 |
指定所选的处理器。 |
几何字段 | 入站事件记录中几何字段或具有 GEOMETRY 标记的字段的名称,处理器将使用该字段计算与地理围栏的并集。 |
替换几何 | 用于指定是否将当前事件记录几何替换为事件记录几何和地理围栏的并集。 默认为是。
|
新几何字段名称 (条件分析) | 将存储事件记录与地理围栏几何的并集的新几何字段的名称。 此参数在替换几何设置为否时显示,设置为是时隐藏。 |
将新几何字段标记为几何 (条件分析) | 指定是否将处理器创建的新几何字段标记为 GEOMETRY。 如果存在多个几何字段,则 GeoEvent Server 将使用 GEOMETRY 标签来标识事件记录的已实现几何。 默认为否。 此参数在替换几何设置为否时显示,设置为是时隐藏。 |
新建 GeoEvent 定义名称 (条件分析) | 分配给新 GeoEvent 定义的名称。 新 GeoEvent 定义将对入站事件记录的方案和其他新几何字段进行组合。 此参数在替换几何设置为否时显示,设置为是时隐藏。 |
地理围栏 | 注册到 GeoEvent Server 的地理围栏的类别和名称。 处理器使用地理围栏来计算其与事件记录几何的几何并集。 处理器支持正则表达式,允许指定一个或多个类别的多个地理围栏。 所需格式为 category/name,以一对正则表达式模式指定。
注:不能将多个地理围栏 category/name 表达式指定为逗号分隔列表。 例如,指定 Countries/France, Countries/Germany 不能用于指定地理围栏 France 或 Germany。 注:类别和名称均使用正则表达式。 表达式 .*/.* 包括所有类别中的所有地理围栏。 请注意,正则表达式模式匹配区分大小写。 |
注意事项和限制
使用并集创建器处理器时,需要牢记几点注意事项:
- 在配置并集创建器处理器时,请考虑参与事件记录和地理围栏的几何。 例如,如果合并事件记录的点几何与几何为面的地理围栏,则将仅生成面几何。 相反,如果合并事件记录的面几何与几何同样为面的地理围栏,则将生成两者的面几何。
- 将事件数据发送到要素服务之前,请考虑将现有事件记录几何替换为并集几何。 要素服务仅支持一个几何类型字段,因此,将对未标记为 GEOMETRY 的字段进行转换并保存为字符串。