写入 JSON 文件

“写入 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 将停止写入当前文件并开始写入新文件的方法。 选项包括按大小和按时间。 默认为按时间。 按大小 - 满足指定的文件大小阈值时，GeoEvent Server 将停止写入当前文件。 满足阈值时将创建新文件。 按时间 - 满足指定的期限阈值时，GeoEvent Server 将停止写入当前文件。 满足阈值时将创建新文件。
文件滚动更新大小(KB) （条件分析）	指定 GeoEvent Server 停止写入之前文件可以达到的最大大小，以千字节 (KB) 为单位。 达到最大文件大小后，GeoEvent Server 将创建一个新文件开始写入。 默认值为 1 千字节。 此参数在文件滚动方法设置为按大小时显示，设置为按时间时隐藏。
文件滚动更新频率 （条件分析）	指定 GeoEvent Server 停止写入当前文件并创建一个新文件开始写入的频率。 可用的基于期限的翻滚策略包括每小时、每天或每月。 默认为每小时。 每小时 - GeoEvent Server 将停止写入当前文件，并每小时开始写入新文件。 每天 - GeoEvent Server 将停止写入当前文件，并每天开始写入新文件。 每月 - GeoEvent Server 将停止写入当前文件，并每月开始写入新文件。 此参数在文件滚动方法设置为按时间时显示，设置为按大小时隐藏。
文件清理期限(分钟)	指定按照文件清理方法参数管理旧文件的期限（以分钟为单位）。 默认值为 4320 分钟。 示例：系统每 3 天（4320 分钟）对文件进行一次删除或存档。
文件清理方法	用于管理已达到文件清理期限（分钟）值的旧文件的方法。 可用的文件清理方法为删除和存档。 默认为删除。 删除 - 达到文件清理期限（分钟）参数中指定期限的文件将被删除。 存档 - 达到文件清理期限（分钟）参数中指定期限的文件将被存档。
归档文件夹 （条件分析）	已注册的系统文件夹，其中已到达文件清理期限（分钟）的文件将被存档。 此参数在文件清理方法设置为存档时显示，设置为删除时隐藏。
归档子文件夹 （条件分析）	与存档文件夹相关的子文件夹，其中已到达文件清理期限（分钟）的文件将被存档。 如果没有用于存档文件的子文件夹，则不指定此参数。 此参数没有默认值。 此参数在文件清理方法设置为存档时显示，设置为删除时隐藏。
格式化的 JSON	指定是否格式化（修饰）通用 JSON。 也称为 PJSON。 此参数的默认值为否。 是 - 通用 JSON 将被格式化（修饰）。 否 - 通用 JSON 不会被格式化。
文件页眉	将插入每个 JSON 文件开头的字符。 GeoEvent Server 可以使用任何普通的 ASCII 字符或字符组合作为文件页眉。 默认为左括号。
文件页脚	将插入每个 JSON 文件末尾的字符。 GeoEvent Server 可以使用任何普通的 ASCII 字符或字符组合作为文件页脚。 默认为右括号。
事件分隔符	将用于分隔 JSON 文件中的每个事件记录的字符。 GeoEvent Server 可以使用任何普通的 ASCII 字符作为事件分隔符。 默认为逗号。