kettle命令运行工具(pan、kitchen、carte)

一、pan：转换命令行工具

命令工具官网文档：Use Command Line Tools to Run Transformations and Jobs - Hitachi Vantara Lumada and Pentaho Documentation

1.1pan基本语法及参数定义

windows 系统使用带有正斜杠 (“/”) 和冒号 (“:”) 的语法。如果选项值中存在空格，请使用单引号 (“) 和双引号 (“”) 将空格放在一起，例如：“-param:MASTER_HOST=192.168.1.3" "-param:MASTER_PORT=8181”

linux语法：pan.sh -option=value arg1 arg2

windows语法：pan.bat /option:value arg1 arg2

pan与kitchen通用参数

Switch	Purpose
rep	企业或数据库存储库名称
user	用户名
pass	密码
dir	存储库目录
file	如果调用的是本地 KTR 文件，则为文件名，如果不在本地目录中，则包括路径
level	日志级别（基本、详细、调试、行级别、错误、无）(Basic, Detailed, Debug, Rowlevel, Error, Nothing)
logfile	将日志输出写入的本地文件名
listdir	列出指定存储库中的目录
listrep	列出可用的存储库
exprep	将所有存储库对象导出到一个 XML 文件
norep	防止 Pan（Kitchen）登录到存储库。如果您已经设置了 KETTLE_REPOSITORY、KETTLE_USER 和 KETTLE_PASSWORD 环境变量，那么这个选项将使您能够阻止 Pan（ Kitchen）登录到指定的存储库，假设您要执行本地 KTR 文件
version	显示版本、修订和构建日期
param	以name=value 格式设置命名参数 。例如： -param:FOO=bar
listparam	列出有关指定转换中定义的命名参数的信息
maxloglines	PDI 内部保留的最大日志行数。设置为 0 以保留所有行（默认）
maxlogtimeout	由 PDI 内部保留的日志行的最长期限（以分钟为单位）。设置为 0 以无限期地保留所有行（默认）

pan独有参数

Switch	Purpose
trans	要启动的转换的名称
listtrans	列出指定存储库目录中的转换
safemode	在安全模式下运行，可以进行额外检查

1.2pan示例

• 运行本地文件

  #windows
  Pan.bat /file:D:\project\pan-mysql-mysql.ktr
  ​
  #linxu
  ./pan.sh -file=./pan-mysql-mysql.ktr
  ./pan.sh /file:./pan-mysql-mysql.ktr

• 使用远程数据库

  #windows
  Pan.bat /rep:kettle-mysql /user:admin /pass:admin /trans:pan_mysql_mysql
  #日志打印：
  Pan.bat /rep:kettle-mysql /user:admin /pass:admin /trans:pan_mysql_mysql /level:Basic>pan_mysql_mysql.log   #默认日志保存在运行命令路径

1.3pan运行状态码

Status Code	Definition
0	转换运行没有问题
1	处理过程中发生错误
2	加载/运行转换期间发生意外错误
3	无法准备和初始化此转换
7	无法从 XML 或存储库加载转换
8	加载步骤或插件时出错（主要是加载插件之一时出错）
9	命令行使用打印

二、kitchen作业命令行工具

2.1kitchen基本语法及参数

linux：kitchen.sh -option=value arg1 arg2

windows：kitchen.bat /option: 值 arg1 arg2

kitchen独有参数：

Switch	Purpose
job	要启动的作业的名称（与存储库中显示的一样）
listjob	列出指定存储库目录中的作业

2.2 kitchen示例

• 运行本地文件

  #windows
  Kitchen.bat /file:D:\project\pan_mysql_mysql.kjb
  ​
  #linux
  ./kitchen.sh -file=./pan_mysql_mysql.kjb
  ./kitchen.sh /file:./pan_mysql_mysql.kjb
  #相对路径：${Internal.Entry.Current.Directory}，该参数要求ktr文件和job文件必须放到同一目录下

• 使用远程数据库

  #windows
  Kitchen.bat /rep:kettle-mysql /user:admin /pass:admin /job:job_Kitchen

2.3kitchen运行状态码

Status Code	Definition
0	工作顺利进行
1	处理过程中发生错误
2	加载或运行作业期间发生意外错误
7	无法从 XML 或存储库加载作业
8	加载步骤或插件时出错（主要是加载插件之一时出错）
9	命令行使用打印

三、carte服务工具

3.1carte服务启动

Carte.bat ip port

Carte.sh ip port

注意，ip需要使用自己服务器的ip，127.0.0.1只能本地使用

#windows
Carte.bat 127.0.0.1 8888
#linux
./carte.sh 127.0.0.1 8888

 

可以用浏览器访问：http://127.0.0.1:8888，默认账号密码都是：cluster

3.2开发配置使用carte服务

转换和作业配置相同

配置子服务器

 

 

配置run configurations

 

 

运行测试

 

打开网页可以查询运行的转换或者作业，网页可以执行基本的运行、停止、删除操作

 

注意，如果使用的是存储库，需要导入开发的repositories.xml文件，开发环境默认路径在$User/.kettle目录下

-----------日常记录---------------

参考官网：Pentaho 9.2 - Hitachi Vantara Lumada and Pentaho Documentation