Explains how to run a job.
When you are ready to run your job, you can:
- Click the Run icon on the toolbar.
- Select Run from the Action menu.
- Press F9.
When you do any of these actions, the Run Options window appears.
In the Run Options window, you can specify whether to run the job locally or on a remote server. You can also specify logging and other options, or experiment by passing temporary values for defined parameters and variables during each iterative run.
Always show dialog on run is set by default. You can deselect this option if you want to use the same run options every time you execute your job. After you have selected to not Always show dialog on run, you can access it again through the dropdown menu next to the Run icon in the toolbar, through the Action main menu, or by pressing F8.
Some ETL activities are lightweight, such as loading in a small text file to write out to a database or filtering a few rows to trim down your results. For these types of lightweight ETL activities, you can simply run your job locally in Spoon. Other ETL activities are more demanding, containing many steps calling other steps or a network of job modules. For these activities, you can set up a separate Pentaho Server dedicated for running jobs.
Choose an Environment Type based on your execution scenario:
|Local||Runs on your local machine.|
|Server||Runs a Pentaho Server. A Carte server environment must be set up for this option to be available. Use Carte Clusters to Run Transformations and Jobs describes how to set up this environment. |
Errors, warnings, and other information generated as the job runs are stored in logs. You can specify how much information is in a log and whether the log is cleared each time through the Options section of this window. You can also enable safe mode and specify whether PDI should gather performance metrics. Logging and Monitoring Operations describes the logging methods available in PDI.
|Clear log before running||Indicates whether to clear all your logs before you run your job. If your log is large, you might need to clear it before the next execution to conserve space.|
|Log level||Specifies how much logging is needed. You can log from Nothing all the way to Rowlevel. |
Debug and Rowlevel logging levels contain information you may consider too sensitive to be shown. Please consider the sensitivity of your data when selecting these logging levels.
Performance Monitoring and Logging describes how best to use these logging methods.
|Enable safe mode||Checks every row passed through your job and ensure all layouts are identical. If a row does not have the same layout as the first row, an error is generated and reported.|
|Start job at||Specifies an alternative starting entry for your job. All the current entries in your job are listed as options in the dropdown menu.|
|Gather performance metrics||Monitors the performance of your job execution through these metrics. Using Performance Graphs shows how to visually analyze these metrics.|
Parameters and Variables
You can temporarily modify parameters and variables for each execution of your job to experimentally determine their best values. The values you enter into these tables are only used when you run the job from the Run Options window. The values you originally defined for these parameters and variables are not permanently changed by the values you specify in these tables.
|Parameters||Set parameter values related to your job during runtime. A parameter is a local variable. The parameters you define while creating your job are shown in the table under the Parameters tab. |
|Set values for user-defined and environment variables related to your job during runtime.|