写日志
组件介绍
组件作用
写日志组件根据用户选择的日志级别在控制台打印前方传入的字段数据或自己在组件中写入的数据。
输入输出描述
- **输入：**上一步骤输出的数据或无
- **输出：**需要被打印到窗口的信息
- 参数：无
组件图标
页面介绍
双击写日志组件可得到如下界面：
参数选项
此界面中的参数选项解释如下：
| 列名 | 说明 | 样例值 |
|---|---|---|
| 日志级别 | 根据不同的需求可以打印出详细程度不一的日志，默认是基本日志。 | |
| 打印头 | 是否打印头部，默认勾 选。 | |
| 限制行数 | 是否限制输出行数。 | |
| 限制行数数值 | 设置限制行数的数值。 | |
| 写日志 | 增加需要在日志中打印的信息。 | |
| 字段 | 字段中的值变更会被打印到日志窗口。 |
日志级别介绍
日志级别的参数选项解释如下：
| 日志级别 | 说明 |
|---|---|
| 基本日志 | 指程序执行过程中的提醒信息，主要用于内核中一些大的动作，主要场景包括：连接池的创建、插件的注册、Pan/Kitchen执行时的版本号、FTP连接的开始等。 |
| 调试 | 指调试程序需要的一些过程性信息，读懂这部分信息，需要对Kettle具备源码级理解。 |
| 详细日志 | 指程序执行过程中的详细信息。这类信息主要用于内核中的动作细节，主要场景包括：执行的每一个数据库SQL、每一个插件类的详情、每一个作业项执行的错误数、每一个资源库对象的加载详情等。 |
| 错误日志 | 输出程序执行过程中发现的异常情况，此日志一般都会包含异常的名称与描述，方便没有开发背景的工程师解决故障。 |
| 最小日志 | 指程序执行过程中的警告信息或者最基础的提示信息，举例来说，数据库驱动不支持在批量操作时处理错误警告信息是最小日志级别；作业中一个子作业的开始与结束提示信息是最小日志级别。 |
| 没有日志 | 程序不会主动输出任何日志信息。 |
| 行级日志 | 是指程序执行过程中精确到每一个数据行的信息。 |
案例示例
读入自定义常量数据，对"log"字段的值在打印台进行输出：
案例操作
自定义常量数据
该步骤定义需要打印的"log"字段。
该组件配置主要分为 2 步： 第一步：在字段标签页插入需要生成的字段名称并设置字段类型，这里插入"log"字段，类型选择为"String"。
第二步：在数据标签页插入需要生成的数据；
写日志
该步骤主要是接收前一个组件传过来的数据并在日志台进行输出。
该组主要配置主要分为 2 步：
第一步：配置需要打印的日志级别；
第二步：输入自己需要输出的数据或配置需要接收的前面传来的数据；
结果预览
在日志台打印的日志信息如下图所示：
