“查看新 CSV 文件的文件夹输入连接器”可用于从系统文件中读取并改编格式化为分隔文本的事件数据。文本分隔符通常为逗号,因此这种类型的输入文件有时被称为逗号分隔值数据文件,但是 ArcGIS GeoEvent Server 可以使用任何普通 ASCII 字符作为分隔符来分隔数据属性值。
通常,数据值非常简单。逗号可用于分隔单个属性值,并且文本字符串值使用双引号括起来,如下图所示。
![文本字符串值使用双引号括起来的逗号分隔值 文本字符串值使用双引号括起来的逗号分隔值](GUID-7DB66701-E29B-48A1-96CD-8CC625FEDA47-web.png)
有时,当数据文件包含用于指定几何值的 JSON 字符串表示时,使用逗号以外的分隔符可以避免在双引号和/或逗号嵌入属性值时出现歧义。以下将说明使用分号字符作为分隔符。
![用于指定几何值的具有 JSON 字符串表示的分号分隔值 用于指定几何值的具有 JSON 字符串表示的分号分隔值](GUID-4F50DC1C-34EA-4737-9E31-E4B35D36C84C-web.png)
用法说明
- 使用此输入连接器可以从系统文件中读取格式化为分隔文本的数据,并对其进行改编以创建事件数据记录以进行处理。
- 此输入连接器可将文本入站适配器与文件入站传输进行配对。
- 输入连接器将查看指定的系统文件夹,当文件出现在文件夹中时,将立即读取整个文件。
- 如果对文件进行更改并保存所作更改,则将重新读取整个文件的内容。
- 如果出现以下情况,则将从文件开头重新读取已查看文件夹中的所有文件:
- 更新并保存输入连接器的属性后。
- 停止并重新启动输入连接器后(或重新启动 ArcGIS GeoEvent Server 服务后)。
- 分隔文本不必包含表示几何的数据。
- 适配器支持根据 X、Y 和 Z 属性值构造点几何的功能。
- 可以使用绝对路径或 UNC 路径来指定已注册服务器文件夹输入文件夹数据存储。如果使用 UNC 路径,则运行 GeoEvent Server 的 Windows 服务帐户需要对文件夹的读/写权限。
- 例如,对于输入文件夹数据存储属性,最佳做法是使用绝对路径,例如 C:\GeoEvent\input。
- 输入目录允许指定相对于已注册服务器文件夹的子文件夹。
- 包括子文件夹用于指定是否应递归搜索输入文件夹数据存储下的文件夹。通常,可以将具有不同方案的数据组织到不同的文件夹中,然后更改包括子文件夹的默认值以禁用递归搜索,由此实现更直接和更简单地配置此输入连接器。
- 如果数据文件具有一个或多个非数据值的标头(例如,字段名称或属性数据类型),请指定从文件开头跳过的行数。如果数据文件特别大,请减小每批的最大行数以通过限制检索文件内容时检索的行数来帮助管理数据检索。您也可以设置批刷新间隔以指定从文件中检索下一批行之前要等待的毫秒数。
- 解析分隔文本需要消息分隔符和属性分隔符。消息分隔符可指示用于标识数据记录结尾的字符,默认为 \n(换行)。属性分隔符可指定用于在单行文本中将一个属性值与另一个属性值分开的字符。上图显示了使用不同字符作为属性分隔符的数据。但是,每个图例均假设换行符为自然的消息分隔符。
单个数据文件可以包含不同类型的数据,例如 Light Truck vs. Tractor Trailer。如果不同的文本行表示来自不同类型传感器或资产的事件数据,则每行文本的第一个属性值必须标识事件记录的类型。属性传入数据包含 GeoEvent 定义可指定连接器是否应使用第一个属性值作为 GeoEvent 定义的名称,以指定后跟的数据类型和属性值的数量。这通常是混乱的根源;如果将此属性设置为是(默认值)并与依赖属性相结合,将创建无法识别的事件定义设置为否(默认值),并提供如上所示的事件数据 - 则不会创建任何事件记录以进行处理。原因是所示事件数据的第一个属性并非 GeoEvent 定义的名称,而是资产唯一名称/标识符,并且不太可能存在名称与所监控的每个资产的唯一标识符相匹配的 GeoEvent 定义。
如果使用设置为是的默认传入数据包含 GeoEvent 定义配置了输入并且将创建无法识别的事件定义属性更改为是,请考虑预期行为。将为每个指定资产或传感器创建新的 GeoEvent 定义。这可能不是您想要的结果,特别是如果数据包含数百个或数千个唯一资产名称时更是如此。要防止上述情况发生,请检查数据,如果每行未以 GeoEvent 定义的名称开头,请将传入数据包含 GeoEvent 定义属性值更改为否。
- 网络延迟可能会对 GeoEvent Server 检索大量的事件数据产生负面影响。
参数
参数 | 说明 |
---|---|
名称 | 用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。 |
输入文件夹数据存储 | 已注册的系统文件夹,在该文件夹下将找到文件。 |
输入目录 | 直接位于已注册的系统文件夹下的子文件夹。 如果注册的系统文件夹下面的子文件夹不存在,则输入目录应留为空白。 |
输入文件过滤器 | 一种正则表达式模式,用于标识适合此输入的文件以进行合并和调整,从而创建要处理的事件数据记录。 默认为 .*\.csv,可匹配以文字后缀 (.csv) 结尾的任何文件名 (.*)。 虽然此参数并非必需且可以留空,但建议您指定一个模式,该模式可与任何文件的文件名匹配,只要该文件的方案与此输入已配置为使用的 GeoEvent 定义匹配,还建议排除您不希望输入合并的文件(按名称)。 |
属于文件文本 | 指定文件是基于文本还是二进制格式。 默认为是。
|
每批的最大行数 (条件分析) | 每个批次或区间中从文件读取的最大行数。 默认为 1000 行。 如果每个事件记录包含许多属性以限制作为批处理发送到文本适配器的数据量,请减小此值。 此参数在属于文件文本设置为是时显示,在设置为否时隐藏。 |
批刷新间隔(毫秒) (条件分析) | 从文件中读取另一批行之前要等待的毫秒数。 默认值为 500。 如果预计文件大小非常大和/或需要额外的时间来处理从文件中检索的每批行,请减小此值。 此参数在属于文件文本设置为是时显示,在设置为否时隐藏。 |
从文件开始处跳过的行数 (条件分析) | 从文件开始处跳过的行数。 默认值为 0。 如果要跳过特定行数(例如,指定属性字段名称或数据类型的标题行),则增加此值,因为这些行中不包含要处理的实际数据。 此参数在属于文件文本设置为是时显示,在设置为否时隐藏。 |
默认空间参考 | 当从坐标不是假定的 WGS84 地理坐标系的纬度和经度值的属性字段值构造几何时使用的空间参考的熟知 ID (WKID),或接收的不包含空间参考的几何字符串。 还可以指定熟知文本 (WKT) 值或包含 WKID 或 WKT 的属性字段的名称。 |
消息分隔符 | 单个文字字符,表示事件数据记录的结束。 Unicode 值可用于指定字符分隔符。 该字符不应用引号括起。 换行符 (\n) 是常见的记录结束分隔符。 |
属性分隔符 | 用于将消息中的一个属性值与另一个属性值分开的单个文字字符。 Unicode 值可用于指定字符分隔符。 该字符不应用引号括起。 逗号 (,) 是常见的属性分隔符 |
传入数据包含 GeoEvent 定义 | 指定是否应将每个分隔行文本的第一个属性值用作 GeoEvent 定义的名称。 有关详细信息,请参阅上面的使用说明。
|
创建无法识别的事件定义 (条件分析) | 指定当具有指定名称的 GeoEvent 定义不存在时是否应创建新的 GeoEvent 定义。 当分隔文本文件包含来自不同类型传感器的事件记录时,第一个属性值用于指定事件类型,此属性值用作 GeoEvent 定义名称。
此参数在传入数据包含 GeoEvent 定义设置为是时显示,在设置为否时隐藏。 |
创建 GeoEvent 定义 (条件分析) | 指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。 GeoEvent Server 需要 GeoEvent 定义,以了解入站事件数据属性字段和数据类型。
此参数在传入数据包含 GeoEvent 定义设置为否时显示,设置为是时隐藏。 |
GeoEvent 定义名称(新) (条件分析) | 分配给新 GeoEvent 定义的名称。 如果已存在具有指定名称的 GeoEvent 定义,则会使用现有的 GeoEvent 定义。 收到的第一个数据记录将用于确定后续数据记录的预期方案,将根据第一个数据记录的方案创建新的 GeoEvent 定义。 此参数在创建 GeoEvent 定义设置为是时显示,设置为否时隐藏。 |
GeoEvent 定义名称(现有) (条件分析) | 在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。 此参数在创建 GeoEvent 定义设置为否时显示,设置为是时隐藏。 |
从字段构建几何 | 指定输入连接器是否应使用作为属性接收的坐标值构造点几何。 默认为否。
|
X 几何字段 (条件分析) | 入站事件数据中的属性字段包含点位置的 X 坐标部分(例如水平或经度)。 此参数在从字段构建几何设置为是时显示,设置为否时隐藏。 |
Y 几何字段 (条件分析) | 入站事件数据中的属性字段包含点位置的 Y 坐标部分(例如垂直或纬度)。 此参数在从字段构建几何设置为是时显示,设置为否时隐藏。 |
Z 几何字段 (条件分析) | 入站事件数据中的属性字段包含点位置的 Z 坐标部分(例如深度或高度)。 如果留空,则将省略 Z 值,并将构建 2D 点几何。 此参数在从字段构建几何设置为是时显示,设置为否时隐藏。 |
预期日期格式 | 该模式用于匹配日期/时间值的预期字符串表示形式,并将它们转换为 Java 日期值。 模式的格式遵循 Java SimpleDateFormat 类约定。 此参数没有默认值。 而 GeoEvent Server 更偏好以 ISO 8601 标准表示的日期/时间值,通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值,且无需指定预期日期格式模式。 其中包括:
如果收到的日期/时间值使用上述五种之一以外的约定表示,则必须指定一个预期日期格式以便 GeoEvent Server 了解如何调整日期/时间值。 |
数字格式化语言 | 从数据值格式化数字时用于区分区域设置敏感行为的区域设置标识符 (ID)。 默认值为安装 GeoEvent Server 的计算机的区域设置。 有关详细信息,请参阅 Java 支持的区域设置。 |
包括子文件夹 | 指定是否在输入文件夹数据存储和输入目录(可选)下的子文件夹中搜索文件。 默认为是,但是,将具有不同方案的数据组织到不同的文件夹中并将此参数更改为否以禁用递归搜索,可实现更简单的配置。
|
处理后删除文件 | 指定在处理内容后是否删除已注册系统文件夹中的文件。 请注意,即使无法调整文件的内容,也不会创建任何事件记录,也不会发生实时事件处理,入站传输仍将删除已成功读取内容的文件。 默认为否。
如果输入连接器的属性已更改并保存,或者输入已停止并重新启动(例如,重新启动 ArcGIS GeoEvent Server 服务时),则将从文件开头重新读取未删除的文件。 |