“写入 JSON 文件”输出连接器可用于将已改编为通用 JSON 的 GeoEvent 写入 JSON 文件。
用法说明
使用“写入 JSON 文件”输出连接器时,应记住以下事项:
- 此输出连接器可将通用 JSON 出站适配器与文件出站传输进行配对。
- 可以使用绝对路径或 UNC 路径来指定已注册服务器文件夹。
- 如果使用 UNC 路径,则运行 GeoEvent Server 的 Windows 服务帐户需要对文件夹的读/写权限。
- 最佳做法是为文件夹参数使用绝对路径,例如 C:\GeoEvent\input。
- 子文件夹参数允许指定相对于已注册服务器文件夹的子文件夹。
- 如果重新启动输出,则 GeoEvent Server 将在已注册系统文件夹路径中创建一个新文件。
- 根据已处理 GeoEvent 的速率和容量,建议将文件滚动更新大小 (KB) 参数增大至超过默认值 1 以避免创建 Windows 无法保持同步的级联 JSON 文件。
- 此输出连接器可将每个事件记录表示为 JSON 文件中的单独 JSON 对象。 将文件标头、文件页脚和事件分隔符参数设置为默认值后,可以在逗号分隔项的有效 JSON 数组中组织每个 JSON 对象。 文件标头的左方括号描述 JSON 数组的开始,文件页脚的右方括号描述 JSON 数组的结尾。 事件分隔符的逗号可分隔每个 JSON 对象。
参数
以下是“写入 JSON 文件”输出连接器的参数:
参数 | 描述 |
---|---|
名称 | 用于在 GeoEvent Manager 中引用的输出连接器的描述性名称。 |
文件夹 | 已注册的系统文件夹,将在该文件夹下创建和写入文件。 |
文件名前缀 | 指定 GeoEvent Server 将创建和写入的输出文件的名称。 首次创建文件的日期/时间会追加到文件名。 默认为输出。 示例:2019 年 3 月 19 日下午 2:30:05 创建的文件名前缀 output 将生成一个名为 output2019-03-19_14-30-05.out 的文件。 |
子文件夹 | 指定相对于已注册的系统文件夹的子文件夹(或子目录)的名称,将在该子文件夹或子目录下创建和写入文件。 如果不存在子文件夹,则此参数应留空。 示例:将已注册的系统文件夹指定为 C:\GeoEvent,则子文件夹 output 会导致 GeoEvent Server 在 C:\GeoEvent\output 中创建文件,即假设文件路径存在且可由运行 ArcGIS GeoEvent Server 的 Windows 服务帐户访问。 |
文件扩展名 | 创建文件时使用的文件扩展名。 此参数的默认值为 json,表示 GeoEvent Server 将创建一个 JSON (.json) 文件。 |
文件滚动更新方法 | 指定用于确定 GeoEvent Server 将停止写入当前文件并开始写入新文件的方法。 选项包括按大小和按时间。 默认为按时间。
|
文件滚动更新大小(KB) (条件分析) | 指定 GeoEvent Server 停止写入之前文件可以达到的最大大小,以千字节 (KB) 为单位。 达到最大文件大小后,GeoEvent Server 将创建一个新文件开始写入。 默认值为 1 千字节。 此参数在文件滚动方法设置为按大小时显示,设置为按时间时隐藏。 |
文件滚动更新频率 (条件分析) | 指定 GeoEvent Server 停止写入当前文件并创建一个新文件开始写入的频率。 可用的基于期限的翻滚策略包括每小时、每天或每月。 默认为每小时。
此参数在文件滚动方法设置为按时间时显示,设置为按大小时隐藏。 |
文件清理期限(分钟) | 指定按照文件清理方法参数管理旧文件的期限(以分钟为单位)。 默认值为 4320 分钟。 示例:系统每 3 天(4320 分钟)对文件进行一次删除或存档。 |
文件清理方法 | 用于管理已达到文件清理期限(分钟)值的旧文件的方法。 可用的文件清理方法为删除和存档。 默认为删除。
|
归档文件夹 (条件分析) | 已注册的系统文件夹,其中已到达文件清理期限(分钟)的文件将被存档。 此参数在文件清理方法设置为存档时显示,设置为删除时隐藏。 |
归档子文件夹 (条件分析) | 与存档文件夹相关的子文件夹,其中已到达文件清理期限(分钟)的文件将被存档。 如果没有用于存档文件的子文件夹,则不指定此参数。 此参数没有默认值。 此参数在文件清理方法设置为存档时显示,设置为删除时隐藏。 |
格式化的 JSON | 指定是否格式化(修饰)通用 JSON。 也称为 PJSON。 此参数的默认值为否。
|
文件页眉 | 将插入每个 JSON 文件开头的字符。 GeoEvent Server 可以使用任何普通的 ASCII 字符或字符组合作为文件页眉。 默认为左括号。 |
文件页脚 | 将插入每个 JSON 文件末尾的字符。 GeoEvent Server 可以使用任何普通的 ASCII 字符或字符组合作为文件页脚。 默认为右括号。 |
事件分隔符 | 将用于分隔 JSON 文件中的每个事件记录的字符。 GeoEvent Server 可以使用任何普通的 ASCII 字符作为事件分隔符。 默认为逗号。 |