轮询 ArcGIS Server 以查找要素

“轮询 ArcGIS Server 以查找要素”输入连接器可用于轮询 ArcGIS Enterprise 或 ArcGIS Online 地图或要素服务图层以查找要素记录，从而将其作为事件记录进行处理。

用法说明

• 使用此输入连接器可从地图或要素服务图层检索要素。
• 此输入连接器将要素 JSON 入站适配器与要素服务入站传输进行配对。 要素 JSON 入站适配器专用于解释要素 JSON。 有关详细信息，请参阅几何对象。
• ArcGIS Enterprise、ArcGIS Online 和 ArcGIS Server（独立）地图和要素服务均受支持。
• 与所有输入连接器一样，需要 GeoEvent 定义。 GeoEvent 定义用于识别正在接收的事件记录的方案。 有关详细信息，请参阅管理 GeoEvent 定义。
• 未包含在 GeoEvent 定义中的事件属性字段的数据值将被忽略。
• 此输入连接器会按照指定间隔定期轮询指定的地图/要素图层。 与任何 web 服务器或 web 服务一样，不建议使用过短的轮询间隔，例如每秒。
• 简单的 WHERE 子句用于识别随每次地图/要素服务轮询返回的要素记录集。 系统默认包括轮询要素记录集中的所有记录例如，WHERE 1=1。 可以修改默认的 WHERE 子句以包括特定的属性值和逻辑条件。
• 支持使用指定几何和空间关系的空间过滤器，例如，面相交。
• 支持从被轮询的地图/要素图层中选择性删除轮询记录。
• 支持唯一功能获取增量更新使用从要素记录检索或从轮询间隔衍生以及从输入连接器缓存的 ObjectID 或时间戳值来轮询新添加或更新的要素记录。
• 将缓存的值加入到连接器的 WHERE 子句中，以查询大于缓存值或相对于现在时间的轮询间隔的记录。
• 有三种方法可用于识别增量更新：ObjectID、时间戳 和截至目前的时间戳。
• 有关详细信息，请参阅 Esri Community 博客轮询要素服务以查找增量更新。

参数

参数	描述
名称	用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。
ArcGIS Server 连接	向 ArcGIS GeoEvent Server 注册为数据存储的 ArcGIS Server、ArcGIS Enterprise 或 ArcGIS Online 连接。 已注册的服务器连接会缓存有关地图/要素服务、其图层和图层属性的信息。
文件夹	ArcGIS Server 服务文件夹、ArcGIS Enterprise 门户或 ArcGIS Online 内容项目文件夹。
服务名称	要轮询要素记录的地图/要素服务的名称。
图层	地图/要素服务要素图层，可通过其访问要素记录。
创建 GeoEvent 定义	指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。 GeoEvent Server 需要 GeoEvent 定义，以了解入站事件数据属性字段和数据类型。 是 - 将根据收到的第一个事件记录的模式创建新的 GeoEvent 定义。 否 - 不会创建新的 GeoEvent 定义。 选择与入站事件数据的方案匹配的现有 GeoEvent 定义。
GeoEvent 定义名称(新) （条件分析）	分配给新 GeoEvent 定义的名称。 如果已存在具有指定名称的 GeoEvent 定义，则会使用现有的 GeoEvent 定义。 收到的第一个数据记录将用于确定后续数据记录的预期方案，将根据第一个数据记录的方案创建新的 GeoEvent 定义。 属性在创建 GeoEvent 定义设置为是时显示，设置为否时隐藏。
GeoEvent 定义名称(现有) （条件分析）	在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。 属性在创建 GeoEvent 定义设置为否时显示，设置为是时隐藏。
刷新间隔	将轮询地图/要素服务要素图层以查找要素记录的时间段（以秒为单位）。 默认为 10（每 10 秒发送一个轮询请求）。
获取增量更新	指定是否仅使用缓存的 ObjectID 或时间戳值请求新要素记录或更新的要素记录。 默认值为否。 是 - GeoEvent Server 将使用缓存的 ObjectID 或时间戳来轮询增量更新。 否 - GeoEvent Server 不会在其要素记录轮询中合并缓存的 ObjectID 或时间戳。 注： 如果删除并重新创建输入连接器，则 ArcGIS GeoEvent Server 服务将停止或重新启动；如果服务器计算机重新启动，则缓存的键值将丢失。 轮询到可用要素记录并检查到从地图/要素服务返回的要素记录集后，将缓存新的键值。
用于标识增量更新的方法 （条件分析）	指定 GeoEvent Server 在轮询增量更新时用于标识新的或更新的要素记录的属性类型。 可用选项包括： ObjectID - GeoEvent Server 将缓存从地图/要素服务轮询返回的要素记录集中最大对象标识符。 只有对象标识符大于上次轮询缓存值的要素才会包含在下一轮询中。 时间戳 - GeoEvent Server 将缓存从地图/要素服务轮询返回的要素记录集中最大时间戳。 只有时间戳大于上次轮询缓存值的要素才会包含在下一轮询中。 截至目前的时间戳 - 专门用于启用编辑者追踪的情况，该选项将使用最后一个轮询时间，而不是轮询要素记录集中的最大时间戳。 例如，如果轮询设置为 300 秒，查询将请求指定的时间戳相对于目前在轮询间隔内的要素记录。 例如，轮询间隔可能为 last_edited_date >= timestamp '2021-09-23 00:38:04.075' and last_edited_date < timestamp '2021-09-23 00:43:04.583'，其中，00:38:04 为最后一次轮询，00:43:04 为五分钟（300 秒）之后。 查询将返回在轮询间隔内编辑的所有要素记录。 属性在获取增量更新设置为是时显示，获取增量更新设置为否时隐藏。
用于标识增量更新的时间字段 （条件分析）	来自 GeoEvent 定义的时间戳字段，其值将用于标识基于时间戳的增量更新。 只能选择数据类型为 Date 的属性。 属性在识别增量更新的方法设置为时间戳或截至目前的时间戳时显示。
查询定义	指定用于限制轮询地图/要素服务要素图层时返回的要素记录的逻辑表达式。 该表达式用作结构化查询语言 (SQL) WHERE 子句中的谓词。 示例包括： 1=1 - 默认，用于构建子句 WHERE 1=1，以轮询所有可用的要素记录。 track_id LIKE '%AJP' - 匹配 TRACK_ID 字符串中任意位置的带有文本字符串 AJP 的要素记录。 reported_dt > timestamp '2019-04-05 22:30:00' - 匹配日期/时间属性值大于指定时间戳的要素记录。
使用几何过滤器	指定是否应将几何对象用作空间过滤器，以限制轮询地图/要素服务要素图层时返回的要素记录。 如果指定几何过滤器，则过滤器将与指定的查询定义组合，以进一步限制从要素图层查询返回的要素记录。 有关详细信息，请参阅几何对象。 是 - 空间过滤器将用于查询要素图层中的要素。 否 - 空间过滤器不会用于查询要素图层中的要素。
过滤几何 （条件分析）	几何对象，使用要素 JSON 表示，用作空间过滤器。 有关正确的几何对象语法的详细信息，请参阅要素和几何。 属性在使用几何过滤器设置为是时显示。
几何类型 （条件分析）	指定几何过滤器的要素 JSON 描述的几何类型。 支持的几何类型包括包络、点、折线、面和多点。 属性在使用几何过滤器设置为是时显示。
空间参考 （条件分析）	指定几何过滤器的空间参考的熟知 ID (WKID)。 属性在使用几何过滤器设置为是时显示。
空间关系 （条件分析）	指定在评估从地图/要素服务要素图层轮询的要素记录时要使用的空间关系，以确定它们是否满足几何过滤器的条件。 属性在使用几何过滤器设置为是时显示。
删除轮询的要素	指定是否应从要素服务要素图层中删除要素服务返回的记录集中的要素记录。 默认为否。