Skip to content

Usage

Reading Kettle files

Use read_kettle_transformation or read_kettle_job to load and inspect an existing file:

json
{
  "name": "read_kettle_transformation",
  "arguments": { "path": "/etl/extract.ktr" }
}

Discovering step types

json
{
  "name": "list_kettle_steps",
  "arguments": { "category": "Input" }
}

Returns all Input step types (TableInput, CSVInput, KafkaConsumer, etc.) with their schemas.

Saving a transformation

json
{
  "name": "save_kettle_transformation",
  "arguments": {
    "path": "/etl/extract.ktr",
    "transformation": { ... },
    "createBackup": true
  }
}

Validating a step configuration

json
{
  "name": "validate_kettle_transformation",
  "arguments": { "path": "/etl/extract.ktr" }
}

Executing a transformation

json
{
  "name": "execute_kettle_transformation",
  "arguments": { "path": "/etl/extract.ktr", "timeoutMs": 30000 }
}

Searching for artifacts

json
{
  "name": "search_kettle_artifacts",
  "arguments": { "query": "customer", "directory": "/etl", "type": "transformation" }
}

All available tools

ToolDescription
read_kettle_jobRead and parse a .kjb file
read_kettle_transformationRead and parse a .ktr file
get_kettle_job_statusGet job structure and validation summary
get_kettle_transformation_statusGet transformation structure and validation summary
validate_kettle_jobValidate a .kjb file
validate_kettle_transformationValidate a .ktr file
list_kettle_stepsList step types (filterable by category/tag)
list_kettle_job_entriesList job entry types (filterable by category/tag)
search_kettle_artifactsSearch for .ktr/.kjb files
list_kettle_artifactsList .ktr/.kjb files in a directory
save_kettle_transformationSave/update a .ktr file
save_kettle_jobSave/update a .kjb file
execute_kettle_transformationExecute a transformation (guarded)
execute_kettle_jobExecute a job (guarded)
start_kettle_transformationStart a transformation
stop_kettle_transformationStop a running transformation
start_kettle_jobStart a job
stop_kettle_jobStop a running job
get_server_statusGet server status and registered artifacts
register_kettle_transformationRegister a transformation path
register_kettle_jobRegister a job path
remove_kettle_transformationUnregister a transformation
remove_kettle_jobUnregister a job
cleanup_kettle_transformationClean temp/log files for a transformation

Released under the MIT License.