FetchFile
描述:
从磁盘读取文件内容，并将文件内容作为数据流输出。完成此操作后，可以选择将文件移动到其他位置或删除该文件以帮助保持文件系统的有序性。
标签:
local, files, filesystem, ingest, ingress, get, source, input, fetch, 文件, 读取
参数:
如下列表中，必填参数则标识为加粗. 其他未加粗参数，则表示为可选参数。表中同时提到参数默认值设置, 并且 参数还支持 表达式语言.
| 名字 | 默认值 | 允许值列表 | 描述 |
|---|---|---|---|
| 读取的文件 | ${absolute.path}/${filename} | 指定将文件系统读取文件内容的文件路径 支持表达式语言 (支持流属性和变量) | |
| 操作策略 | 无 | - 无  - 移动文件 - 删除文件 | 当原始文件读取完成之后，指定后续相关操作策略 |
| 移动目标目录 | 从文件系统获取原始文件后将目标移动到的目录。除非“操作策略”设置为“移动文件”，否则将忽略此属性。如果该目录不存在，则将创建该目录。 支持表达式语言 (支持流属性和变量) | ||
| 移动冲突策略 | 重命名 | - 重命名 - 替换文件 - 保持现有 - 失败 | 如果“操作策略”设置为“移动文件”并且目标目录中已存在同名文件，则此属性指定应如何处理命名冲突 |
| 文件不存在时的日志级别 | 错误 | - 跟踪 - 调试 - 信息 - 警告 - 错误 - 失败 - 无 | 执行该组件时文件不存在所使用的日志级别 |
| 权限受限时的日志级别 | 错误 | - 跟踪 - 调试 - 信息 - 警告 - 错误 - 失败 - 无 | 当前平台的启动用户没有足够权限读取文件时使用的日志级别 |
连线:
| 名字 | 描述 |
|---|---|
| success | 成功读取文件内容后，将通过该数据流输出。 |
| not.found | 由于找不到文件而无法从文件系统读取文件内容，则直接将输入流通过该数据流输出。 |
| permission.denied | 由于用户运行的该平台没有足够的权限而无法从文件系统读取文件内容，则直接将输入流通过该数据流输出。 |
| failure | 由于权限不足或文件不存在而无法从文件系统读取文件内容，则直接将输入流通过该数据流输出。 |
读取属性:
未提供。
写入属性:
未提供。
状态管理:
该组件不保存状态。
限制:
| 要求权限 | 说明 |
|---|---|
| 读文件系统 | 基于当前平台可访问的权限，提供相应的读取文件操作权限。 |
| 写文件系统 | 基于当前平台可访问的权限，提供相应的写入文件操作权限。 |
输入流要求:
组件必须提供输入流。
系统资源考量:
未提供。