写入 CSV 文件

“写入 CSV 文件”输出连接器可用于将已改编为文本的事件记录写入分隔文本文件。 文本分隔符通常为逗号，因此这种类型的输出文件有时被称为逗号分隔值文件，但是 ArcGIS GeoEvent Server 可以使用任何普通 ASCII 字符作为分隔符来分隔数据属性值。

用法说明

使用“写入 CSV 文件”输出连接器时，应记住以下事项：

• 此输出连接器可将文本出站适配器与文件出站传输进行配对。
• 可以使用绝对路径或 UNC 路径来指定已注册服务器文件夹。
• 如果使用 UNC 路径，则运行 GeoEvent Server 的 Windows 服务账户需要对文件夹的读/写权限。
• 最佳做法是使用绝对路径。 例如，为文件夹参数使用 C:\GeoEvent\output。
• 子文件夹参数允许指定相对于已注册服务器文件夹的子文件夹。
• 如果重新启动输出，则 GeoEvent Server 将在已注册系统文件夹路径中创建一个新文件。
• 根据已处理事件记录的速率和容量，建议将文件滚动更新大小 (KB) 参数增大至超过默认值 1 以避免创建 Windows 无法保持同步的级联分隔文本文件。
• 将已处理的事件记录改编为分隔文本需要消息分隔符参数和属性分隔符参数。
• 文件扩展名参数可用于指定 GeoEvent Server 创建的分隔文本文件的类型。 虽然此输出连接器的默认值为 csv，但是也可以指定其他文件扩展名，例如 txt 或 out 以创建不同的分隔文本文件。
• 建议将输出日期格式参数设置为 ISO 8601 格式。 GeoEvent Server 首选以 ISO 8601 格式表示日期和时间值，但是，也可以指定和使用其他所需的日期格式。

参数

“写入 CSV 文件”输出连接器的参数如下所述：

参数	描述
名称	用于在 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 服务账户访问。
文件滚动更新方法	指定用于确定 GeoEvent Server 停止写入当前文件并开始写入新文件的方法。 选项包括按大小和按时间。 默认为按时间。 按大小 - 当达到指定的文件大小阈值时，GeoEvent Server 停止写入当前文件并创建新文件。 按时间 - 当达到指定的时限阈值时， GeoEvent Server停止写入当前文件并创建新文件。
文件滚动更新大小(KB) （条件分析）	指定 GeoEvent Server 停止写入之前文件可以达到的最大大小，以千字节 (KB) 为单位。 达到最大文件大小后，GeoEvent Server 将创建一个新文件开始写入。 默认值为 1 千字节。 此参数在文件滚动方法设置为按大小时显示，设置为按时间时隐藏。
文件滚动更新频率 （条件分析）	指定 GeoEvent Server 停止写入当前文件并创建一个新文件开始写入的频率。 可用的基于期限的滚动选项包括每小时、每天和每月。 默认为每小时。 每小时 - GeoEvent Server 将停止写入当前文件，并且每小时都开始写入新文件。 每天 - GeoEvent Server 将停止写入当前文件，并且每天都开始写入新文件。 每月 - GeoEvent Server 将停止写入当前文件，并且每月都开始写入新文件。 此参数在文件滚动方法设置为按时间时显示，设置为按大小时隐藏。
文件清理期限(分钟)	指定按照文件清理方法参数管理现有文件的期限（以分钟为单位）。 默认值为 4320 分钟。 例如：每 3 天（4,320 分钟）对文件进行一次删除或存档。
文件清理方法	用于管理已达到文件清理期限（分钟）值的现有文件的方法。 文件清理选项为删除和存档。 默认为删除。 删除 - 达到文件清理期限（分钟）参数中指定期限的文件将被删除。 存档 - 达到文件清理期限（分钟）参数中指定期限的文件将被存档。
归档文件夹 （条件分析）	已注册的系统文件夹，其中已到达文件清理期限（分钟）值的文件将被存档。 此参数在文件清理方法设置为存档时显示，设置为删除时隐藏。
归档子文件夹 （条件分析）	与存档文件夹值相关的子文件夹，其中已到达文件清理期限（分钟）值的文件将被存档。 如果没有用于存档文件的子文件夹，则不指定此参数。 此参数没有默认值。 此参数在文件清理方法设置为存档时显示，设置为删除时隐藏。
消息分隔符	用作事件记录分隔符的文字字符。 默认使用 \n 作为换行符。
属性分隔符	用作属性字段分隔符的文字字符。 默认为逗号。
文件扩展名	创建文件时使用的文件扩展名。 此参数的默认值为 CSV。
输出日期格式	指定写入文件的日期/时间值的格式。 输出日期格式选项为 ISO 8601 格式和自定义格式。 默认为 ISO 8601格式。 ISO 8601格式 - 处理的日期/时间值按照 ISO 8601 格式构建 (yyyy-MM-dd'T'HH:mm:ss.SSSXXX)。 自定义格式 - 使用 Java SimpleDateFormat 类约定按照自定义格式构建已处理的日期/时间值。
自定义日期格式 （条件分析）	写入文件的日期/时间值的自定义格式。 使用 Java SimpleDateFormat 类约定构造自定义日期格式。 有关详细信息，请参阅 Oracle 文档中的 SimpleDateFormat 类。 此参数在输出日期格式设置为自定义格式时显示，设置为 ISO 8601 格式时隐藏。
数字格式化语言	从数据值格式化数字时用于区分区域设置敏感行为的区域设置标识符 (ID)。 默认值为安装 GeoEvent Server 的计算机的区域设置。 有关详细信息，请参阅 Java 支持的区域设置。