public class BaseStep extends Object implements org.pentaho.di.core.variables.VariableSpace, StepInterface, org.pentaho.di.core.logging.LoggingObjectInterface, org.pentaho.di.core.ExtensionDataInterface
The implementing class can rely mostly on the base class, and has only three important methods it implements itself. The three methods implement the step lifecycle during transformation execution: initialization, row processing, and clean-up.
public boolean init(...)Every step is given the opportunity to do one-time initialization tasks like opening files or establishing database connections. For any steps derived from BaseStep it is mandatory that super.init() is called to ensure correct behavior. The method must return true in case the step initialized correctly, it must returned false if there was an initialization error. PDI will abort the execution of a transformation in case any step returns false upon initialization.
public boolean processRow(...)A typical implementation queries for incoming input rows by calling getRow(), which blocks and returns a row object or null in case there is no more input. If there was an input row, the step does the necessary row processing and calls putRow() to pass the row on to the next step. If there are no more rows, the step must call setOutputDone() and return false.
Formally the method must conform to the following rules:
public void dispose(...)Steps are required to deallocate resources allocated during init() or subsequent row processing. This typically means to clear all fields of the StepDataInterface object, and to ensure that all open files or connections are properly closed. For any steps derived from BaseStep it is mandatory that super.dispose() is called to ensure correct deallocation.
| Modifier and Type | Field and Description |
|---|---|
boolean |
first
if true then the row being processed is the first row
|
long |
linesInput
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesOutput
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesRead
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesRejected
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesSkipped
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesUpdated
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
long |
linesWritten
Deprecated.
please use the supplied getters, setters and increment/decrement methods
|
boolean |
terminator |
List<Object[]> |
terminator_rows |
| Constructor and Description |
|---|
BaseStep(StepMeta stepMeta,
StepDataInterface stepDataInterface,
int copyNr,
TransMeta transMeta,
Trans trans)
This is the base step that forms that basis for all steps.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addResultFile(org.pentaho.di.core.ResultFile resultFile)
Adds the result file.
|
void |
addRowListener(RowListener rowListener)
Add a rowlistener to the step allowing you to inspect (or manipulate, be careful) the rows coming in or exiting the step.
|
void |
addStepListener(StepListener stepListener)
Attach a step listener to be notified when a step arrives in a certain state.
|
void |
batchComplete()
Calling this method will alert the step that we finished passing a batch of records to the step.
|
org.pentaho.di.core.RowMetaAndData |
buildLog(String sname,
int copynr,
long lines_read,
long lines_written,
long lines_updated,
long lines_skipped,
long errors,
Date start_date,
Date end_date)
Builds the log.
|
boolean |
canProcessOneRow()
This method checks if the step is capable of processing at least one row.
|
void |
cleanup()
Call this method typically, after ALL the slave transformations in a clustered run have finished.
|
static void |
closeQuietly(Closeable cl)
Close quietly.
|
void |
copyVariablesFrom(org.pentaho.di.core.variables.VariableSpace space) |
long |
decrementLinesRead()
Decrements the number of lines read from previous steps by one
|
long |
decrementLinesWritten()
Decrements the number of lines written to next steps by one
|
void |
dispatch()
This method finds the surrounding steps and rowsets for this base step.
|
void |
dispose(StepMetaInterface smi,
StepDataInterface sdi)
Dispose of this step: close files, empty logs, etc.
|
String |
environmentSubstitute(String aString) |
String[] |
environmentSubstitute(String[] aString) |
String |
fieldSubstitute(String aString,
org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] rowData) |
org.pentaho.di.core.RowSet |
findInputRowSet(String sourceStep)
Find input row set.
|
org.pentaho.di.core.RowSet |
findInputRowSet(String from,
int fromcopy,
String to,
int tocopy)
Find input row set.
|
org.pentaho.di.core.RowSet |
findOutputRowSet(String targetStep)
Find output row set.
|
org.pentaho.di.core.RowSet |
findOutputRowSet(String from,
int fromcopy,
String to,
int tocopy)
Find an output rowset in a running transformation.
|
boolean |
getBooleanValueOfVariable(String variableName,
boolean defaultValue) |
int |
getClusterSize()
Returns the cluster size.
|
String |
getContainerObjectId()
Returns the container object ID.
|
int |
getCopy() |
int |
getCurrentInputRowSetNr() |
int |
getCurrentOutputRowSetNr() |
Trans |
getDispatcher()
Gets the dispatcher.
|
org.pentaho.di.core.row.RowMetaInterface |
getErrorRowMeta() |
long |
getErrors()
Get the number of errors
|
Map<String,Object> |
getExtensionDataMap() |
String |
getFilename() |
org.pentaho.di.core.row.RowMetaInterface |
getInputRowMeta() |
List<org.pentaho.di.core.RowSet> |
getInputRowSets() |
long |
getLinesInput() |
long |
getLinesOutput() |
long |
getLinesRead() |
long |
getLinesRejected() |
long |
getLinesSkipped() |
long |
getLinesUpdated() |
long |
getLinesWritten() |
org.pentaho.di.core.logging.LogChannelInterface |
getLogChannel() |
String |
getLogChannelId() |
static org.pentaho.di.core.row.RowMetaInterface |
getLogFields(String comm)
Gets the log fields.
|
org.pentaho.di.core.logging.LogLevel |
getLogLevel() |
org.pentaho.metastore.api.IMetaStore |
getMetaStore() |
int |
getNextClassNr()
Gets the next class nr.
|
String |
getObjectCopy() |
org.pentaho.di.repository.ObjectId |
getObjectId() |
String |
getObjectName() |
org.pentaho.di.repository.ObjectRevision |
getObjectRevision() |
org.pentaho.di.core.logging.LoggingObjectType |
getObjectType() |
List<org.pentaho.di.core.RowSet> |
getOutputRowSets() |
org.pentaho.di.core.logging.LoggingObjectInterface |
getParent() |
org.pentaho.di.core.variables.VariableSpace |
getParentVariableSpace() |
String |
getPartitionID() |
Map<String,org.pentaho.di.core.BlockingRowSet> |
getPartitionTargets() |
org.pentaho.di.core.row.RowMetaInterface |
getPreviewRowMeta() |
long |
getProcessed() |
Date |
getRegistrationDate()
Returns the registration date
|
List<RemoteStep> |
getRemoteInputSteps()
Gets the remote input steps.
|
List<RemoteStep> |
getRemoteOutputSteps()
Gets the remote output steps.
|
int |
getRepartitioning() |
Repository |
getRepository() |
org.pentaho.di.repository.RepositoryDirectory |
getRepositoryDirectory() |
Map<String,org.pentaho.di.core.ResultFile> |
getResultFiles() |
Object[] |
getRow()
In case of getRow, we receive data from previous steps through the input
rowset.
|
Object[] |
getRowFrom(org.pentaho.di.core.RowSet rowSet)
Gets the row from.
|
List<RowListener> |
getRowListeners() |
long |
getRuntime() |
List<ServerSocket> |
getServerSockets()
Returns the serverSockets.
|
int |
getSlaveNr()
Returns the unique slave number in the cluster.
|
SocketRepository |
getSocketRepository()
Retutns the socket repository.
|
BaseStepData.StepExecutionStatus |
getStatus() |
String |
getStatusDescription()
Gets the status description.
|
StepDataInterface |
getStepDataInterface() |
String |
getStepID() |
List<StepListener> |
getStepListeners()
Returns the step listeners.
|
StepMeta |
getStepMeta() |
StepMetaInterface |
getStepMetaInterface() |
String |
getStepname()
Get the name of the step.
|
Trans |
getTrans() |
TransMeta |
getTransMeta() |
String |
getTypeId()
Returns the step ID via the getStepID() method call.
|
int |
getUniqueStepCountAcrossSlaves()
Returns the number of unique steps across all slave servers.
|
int |
getUniqueStepNrAcrossSlaves()
Returns a unique step number across all slave servers: slaveNr * nrCopies + copyNr.
|
String |
getVariable(String variableName) |
String |
getVariable(String variableName,
String defaultValue) |
void |
identifyErrorOutput()
To be used to flag an error output channel of a step prior to execution for performance reasons.
|
long |
incrementLinesInput()
Increments the number of lines read from an input source: database, file, socket, etc.
|
long |
incrementLinesOutput()
Increments the number of lines written to an output target: database, file, socket, etc.
|
long |
incrementLinesRead()
Increments the number of lines read from previous steps by one
|
long |
incrementLinesRejected()
Increments the number of lines rejected to an error handling step
|
long |
incrementLinesSkipped()
Increments the number of lines skipped
|
long |
incrementLinesUpdated()
Increments the number of lines updated in an output target: database, file, socket, etc.
|
long |
incrementLinesWritten()
Increments the number of lines written to next steps by one
|
boolean |
init(StepMetaInterface smi,
StepDataInterface sdi)
Initialize and do work where other steps need to wait for...
|
void |
initBeforeStart()
This method is executed by Trans right before the threads start and right after initialization.
|
void |
initializeVariablesFrom(org.pentaho.di.core.variables.VariableSpace parent) |
void |
injectVariables(Map<String,String> prop) |
boolean |
isBasic()
Checks if is basic.
|
boolean |
isDebug()
Checks if is debug.
|
boolean |
isDetailed()
Checks if is detailed.
|
boolean |
isDistributed() |
boolean |
isForcingSeparateLogging() |
boolean |
isGatheringMetrics() |
boolean |
isInitialising()
Checks if is initialising.
|
boolean |
isMapping() |
boolean |
isPartitioned() |
boolean |
isPaused() |
boolean |
isRowLevel()
Checks if is row level.
|
boolean |
isRunning() |
boolean |
isStopped() |
boolean |
isUsingThreadPriorityManagment()
Retusn true if we are actively managing priorities of step threads.
|
String[] |
listVariables() |
void |
logBasic(String message)
Log basic.
|
void |
logBasic(String message,
Object... arguments)
Log basic.
|
void |
logDebug(String message)
Log debug.
|
void |
logDebug(String message,
Object... arguments)
Log debug.
|
void |
logDetailed(String message)
Log detailed.
|
void |
logDetailed(String message,
Object... arguments)
Log detailed.
|
void |
logError(String message)
Log error.
|
void |
logError(String message,
Object... arguments)
Log error.
|
void |
logError(String message,
Throwable e)
Log error.
|
void |
logMinimal(String message)
Log minimal.
|
void |
logMinimal(String message,
Object... arguments)
Log minimal.
|
void |
logRowlevel(String message)
Log rowlevel.
|
void |
logRowlevel(String message,
Object... arguments)
Log rowlevel.
|
void |
logSummary()
Log summary.
|
void |
markStart()
Mark the start time of the step.
|
void |
markStop()
Mark the end time of the step.
|
boolean |
outputIsDone()
Output is done.
|
void |
pauseRunning()
Pause a running step
|
boolean |
processRow(StepMetaInterface smi,
StepDataInterface sdi)
Perform the equivalent of processing one row.
|
void |
putError(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row,
long nrErrors,
String errorDescriptions,
String fieldNames,
String errorCodes)
Put error.
|
void |
putRow(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row)
putRow is used to copy a row, to the alternate rowset(s) This should get priority over everything else!
(synchronized) If distribute is true, a row is copied only once to the output rowsets, otherwise copies are sent
to each rowset!
|
void |
putRowTo(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row,
org.pentaho.di.core.RowSet rowSet)
putRowTo is used to put a row in a certain specific RowSet.
|
void |
removeRowListener(RowListener rowListener)
Remove a rowlistener from this step.
|
void |
resumeRunning()
Resume a running step
|
int |
rowsetInputSize() |
int |
rowsetOutputSize() |
static void |
safeModeChecking(org.pentaho.di.core.row.RowMetaInterface referenceRowMeta,
org.pentaho.di.core.row.RowMetaInterface rowMeta)
Safe mode checking.
|
void |
setCarteObjectId(String containerObjectId)
Sets the container object ID.
|
void |
setCopy(int cop)
Sets the copy.
|
void |
setCurrentInputRowSetNr(int index) |
void |
setCurrentOutputRowSetNr(int index) |
void |
setDistributed(boolean distributed) |
void |
setErrorRowMeta(org.pentaho.di.core.row.RowMetaInterface errorRowMeta) |
void |
setErrors(long e)
Sets the number of errors
|
void |
setForcingSeparateLogging(boolean forcingSeparateLogging) |
void |
setGatheringMetrics(boolean gatheringMetrics) |
void |
setInputRowMeta(org.pentaho.di.core.row.RowMetaInterface rowMeta) |
void |
setInputRowSets(List<org.pentaho.di.core.RowSet> inputRowSets) |
void |
setInternalVariables()
Sets the internal variables.
|
void |
setLinesInput(long newLinesInputValue) |
void |
setLinesOutput(long newLinesOutputValue) |
void |
setLinesRead(long newLinesReadValue) |
void |
setLinesRejected(long newLinesRejectedValue) |
void |
setLinesSkipped(long newLinesSkippedValue) |
void |
setLinesUpdated(long newLinesUpdatedValue) |
void |
setLinesWritten(long newLinesWrittenValue) |
void |
setLogLevel(org.pentaho.di.core.logging.LogLevel logLevel)
Sets the log level.
|
void |
setMetaStore(org.pentaho.metastore.api.IMetaStore metaStore)
Pass along the metastore to use when loading external elements at runtime.
|
void |
setOutputDone()
Signal output done to destination steps
|
void |
setOutputRowSets(List<org.pentaho.di.core.RowSet> outputRowSets) |
void |
setParentVariableSpace(org.pentaho.di.core.variables.VariableSpace parent) |
void |
setPartitioned(boolean partitioned) |
void |
setPartitionID(String partitionID) |
void |
setPartitionTargets(Map<String,org.pentaho.di.core.BlockingRowSet> partitionTargets) |
void |
setPaused(AtomicBoolean paused)
Sets the paused.
|
void |
setPaused(boolean paused)
Sets the paused.
|
void |
setPreviewRowMeta(org.pentaho.di.core.row.RowMetaInterface previewRowMeta) |
void |
setRepartitioning(int repartitioning) |
void |
setRepository(Repository repository) |
void |
setRunning(boolean running)
Flag the step as running or not
|
void |
setServerSockets(List<ServerSocket> serverSockets) |
void |
setSocketRepository(SocketRepository socketRepository)
Sets the socket repository.
|
void |
setStepDataInterface(StepDataInterface stepDataInterface) |
void |
setStepListeners(List<StepListener> stepListeners)
Sets the step listeners.
|
void |
setStepMeta(StepMeta stepMeta) |
void |
setStepMetaInterface(StepMetaInterface stepMetaInterface) |
void |
setStepname(String stepname)
Sets the stepname.
|
void |
setStopped(boolean stopped) |
void |
setTransMeta(TransMeta transMeta) |
void |
setUsingThreadPriorityManagment(boolean usingThreadPriorityManagment)
Set to true to actively manage priorities of step threads.
|
void |
setVariable(String variableName,
String variableValue) |
void |
shareVariablesWith(org.pentaho.di.core.variables.VariableSpace space) |
void |
stopAll()
Flags all rowsets as stopped/completed/finished.
|
void |
stopRunning()
Deprecated.
|
void |
stopRunning(StepMetaInterface stepMetaInterface,
StepDataInterface stepDataInterface)
Perform actions to stop a running step.
|
String |
toString() |
@Deprecated public long linesRead
@Deprecated public long linesWritten
@Deprecated public long linesInput
@Deprecated public long linesOutput
@Deprecated public long linesUpdated
@Deprecated public long linesSkipped
@Deprecated public long linesRejected
public boolean first
public boolean terminator
public BaseStep(StepMeta stepMeta, StepDataInterface stepDataInterface, int copyNr, TransMeta transMeta, Trans trans)
stepMeta - The StepMeta object to run.stepDataInterface - the data object to store temporary data, database connections, caches, result sets,
hashtables etc.copyNr - The copynumber for this step.transMeta - The TransInfo of which the step stepMeta is part of.trans - The (running) transformation to obtain information shared among the steps.public boolean init(StepMetaInterface smi, StepDataInterface sdi)
StepInterfaceinit in interface StepInterfacesmi - The metadata to work withsdi - The data to initializepublic void dispose(StepMetaInterface smi, StepDataInterface sdi)
StepInterfacedispose in interface StepInterfacesmi - The metadata to work withsdi - The data to dispose ofpublic void cleanup()
StepInterfacecleanup in interface StepInterfacepublic long getProcessed()
getProcessed in interface StepInterfacepublic void setCopy(int cop)
cop - the new copypublic int getCopy()
getCopy in interface StepInterfacepublic long getErrors()
StepInterfacegetErrors in interface StepInterfacepublic void setErrors(long e)
StepInterfacesetErrors in interface StepInterfacee - the number of errors to setpublic long getLinesRead()
getLinesRead in interface StepInterfacepublic long incrementLinesRead()
public long decrementLinesRead()
public void setLinesRead(long newLinesReadValue)
newLinesReadValue - the new number of lines read from previous stepspublic long getLinesInput()
getLinesInput in interface StepInterfacepublic long incrementLinesInput()
public void setLinesInput(long newLinesInputValue)
newLinesInputValue - the new number of lines read from an input source: database, file, socket, etc.public long getLinesOutput()
getLinesOutput in interface StepInterfacepublic long incrementLinesOutput()
public void setLinesOutput(long newLinesOutputValue)
newLinesOutputValue - the new number of lines written to an output target: database, file, socket, etc.public long getLinesWritten()
getLinesWritten in interface StepInterfacepublic long incrementLinesWritten()
public long decrementLinesWritten()
public void setLinesWritten(long newLinesWrittenValue)
newLinesWrittenValue - the new number of lines written to next stepspublic long getLinesUpdated()
getLinesUpdated in interface StepInterfacepublic long incrementLinesUpdated()
public void setLinesUpdated(long newLinesUpdatedValue)
newLinesOutputValue - the new number of lines updated in an output target: database, file, socket, etc.public long getLinesRejected()
getLinesRejected in interface StepInterfacepublic long incrementLinesRejected()
public void setLinesRejected(long newLinesRejectedValue)
setLinesRejected in interface StepInterfacenewLinesRejectedValue - lines number of lines rejected to an error handling steppublic long getLinesSkipped()
public long incrementLinesSkipped()
public void setLinesSkipped(long newLinesSkippedValue)
newLinesSkippedValue - lines number of lines skippedpublic String getStepname()
StepInterfacegetStepname in interface StepInterfacepublic void setStepname(String stepname)
stepname - the new stepnamepublic Trans getDispatcher()
public String getStatusDescription()
public StepMetaInterface getStepMetaInterface()
public void setStepMetaInterface(StepMetaInterface stepMetaInterface)
stepMetaInterface - The stepMetaInterface to set.public StepDataInterface getStepDataInterface()
public void setStepDataInterface(StepDataInterface stepDataInterface)
stepDataInterface - The stepDataInterface to set.public StepMeta getStepMeta()
getStepMeta in interface StepInterfacepublic void setStepMeta(StepMeta stepMeta)
stepMeta - The stepMeta to set.public TransMeta getTransMeta()
public void setTransMeta(TransMeta transMeta)
transMeta - The transMeta to set.public Trans getTrans()
getTrans in interface StepInterfacepublic void putRow(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row)
throws org.pentaho.di.core.exception.KettleStepException
putRow in interface StepInterfacerow - The row to put to the destination rowset(s).rowMeta - The row to send to the destinations stepsorg.pentaho.di.core.exception.KettleStepExceptionpublic void putRowTo(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row,
org.pentaho.di.core.RowSet rowSet)
throws org.pentaho.di.core.exception.KettleStepException
rowMeta - The row meta-data to put to the destination RowSet.row - the data to put in the RowSetrowSet - the RoWset to put the row into.org.pentaho.di.core.exception.KettleStepException - In case something unexpected goes wrongpublic void putError(org.pentaho.di.core.row.RowMetaInterface rowMeta,
Object[] row,
long nrErrors,
String errorDescriptions,
String fieldNames,
String errorCodes)
throws org.pentaho.di.core.exception.KettleStepException
rowMeta - the row metarow - the rownrErrors - the nr errorserrorDescriptions - the error descriptionsfieldNames - the field nameserrorCodes - the error codesorg.pentaho.di.core.exception.KettleStepException - the kettle step exceptionpublic Object[] getRow() throws org.pentaho.di.core.exception.KettleException
getRow in interface StepInterfaceorg.pentaho.di.core.exception.KettleExceptionpublic void identifyErrorOutput()
StepInterfaceidentifyErrorOutput in interface StepInterfacepublic static void safeModeChecking(org.pentaho.di.core.row.RowMetaInterface referenceRowMeta,
org.pentaho.di.core.row.RowMetaInterface rowMeta)
throws org.pentaho.di.core.exception.KettleRowException
referenceRowMeta - the reference row metarowMeta - the row metaorg.pentaho.di.core.exception.KettleRowException - the kettle row exceptionpublic Object[] getRowFrom(org.pentaho.di.core.RowSet rowSet) throws org.pentaho.di.core.exception.KettleStepException
rowSet - the row setorg.pentaho.di.core.exception.KettleStepException - the kettle step exceptionpublic org.pentaho.di.core.RowSet findInputRowSet(String sourceStep) throws org.pentaho.di.core.exception.KettleStepException
sourceStep - the source steporg.pentaho.di.core.exception.KettleStepException - the kettle step exceptionpublic org.pentaho.di.core.RowSet findInputRowSet(String from, int fromcopy, String to, int tocopy)
from - the fromfromcopy - the fromcopyto - the totocopy - the tocopypublic org.pentaho.di.core.RowSet findOutputRowSet(String targetStep) throws org.pentaho.di.core.exception.KettleStepException
targetStep - the target steporg.pentaho.di.core.exception.KettleStepException - the kettle step exceptionpublic org.pentaho.di.core.RowSet findOutputRowSet(String from, int fromcopy, String to, int tocopy)
from - fromcopy - to - tocopy - public void setOutputDone()
StepInterfacesetOutputDone in interface StepInterfacepublic void dispatch()
public boolean isBasic()
public boolean isDetailed()
public boolean isDebug()
public boolean isRowLevel()
public void logMinimal(String message)
message - the messagepublic void logMinimal(String message, Object... arguments)
message - the messagearguments - the argumentspublic void logBasic(String message)
message - the messagepublic void logBasic(String message, Object... arguments)
message - the messagearguments - the argumentspublic void logDetailed(String message)
message - the messagepublic void logDetailed(String message, Object... arguments)
message - the messagearguments - the argumentspublic void logDebug(String message)
message - the messagepublic void logDebug(String message, Object... arguments)
message - the messagearguments - the argumentspublic void logRowlevel(String message)
message - the messagepublic void logRowlevel(String message, Object... arguments)
message - the messagearguments - the argumentspublic void logError(String message)
message - the messagepublic void logError(String message, Throwable e)
message - the messagee - the epublic void logError(String message, Object... arguments)
message - the messagearguments - the argumentspublic int getNextClassNr()
public boolean outputIsDone()
public void stopAll()
StepInterfacestopAll in interface StepInterfacepublic boolean isStopped()
isStopped in interface StepInterfacepublic boolean isRunning()
isRunning in interface StepInterfacepublic boolean isPaused()
isPaused in interface StepInterfacepublic void setStopped(boolean stopped)
setStopped in interface StepInterfacestopped - true if the step needs to be stoppedpublic void setRunning(boolean running)
StepInterfacesetRunning in interface StepInterfacerunning - the running flag to setpublic void pauseRunning()
StepInterfacepauseRunning in interface StepInterfacepublic void resumeRunning()
StepInterfaceresumeRunning in interface StepInterfacepublic void setPaused(boolean paused)
paused - the new pausedpublic void setPaused(AtomicBoolean paused)
paused - the new pausedpublic boolean isInitialising()
public void markStart()
StepInterfacemarkStart in interface StepInterfacepublic void setInternalVariables()
public void markStop()
StepInterfacemarkStop in interface StepInterfacepublic long getRuntime()
getRuntime in interface StepInterfacepublic org.pentaho.di.core.RowMetaAndData buildLog(String sname, int copynr, long lines_read, long lines_written, long lines_updated, long lines_skipped, long errors, Date start_date, Date end_date)
sname - the snamecopynr - the copynrlines_read - the lines_readlines_written - the lines_writtenlines_updated - the lines_updatedlines_skipped - the lines_skippederrors - the errorsstart_date - the start_dateend_date - the end_datepublic static final org.pentaho.di.core.row.RowMetaInterface getLogFields(String comm)
comm - the commpublic int rowsetOutputSize()
rowsetOutputSize in interface StepInterfacepublic int rowsetInputSize()
rowsetInputSize in interface StepInterfacepublic void stopRunning(StepMetaInterface stepMetaInterface, StepDataInterface stepDataInterface) throws org.pentaho.di.core.exception.KettleException
stopRunning in interface StepInterfacestepDataInterface - The interface to the step data containing the connections, resultsets, open files, etc.stepMetaInterface - The metadata that might be needed by the step to stop running.org.pentaho.di.core.exception.KettleException - in case something goes wrong@Deprecated public void stopRunning()
public void logSummary()
public String getStepID()
getStepID in interface StepInterfacepublic List<org.pentaho.di.core.RowSet> getInputRowSets()
getInputRowSets in interface StepInterfacepublic void setInputRowSets(List<org.pentaho.di.core.RowSet> inputRowSets)
inputRowSets - The inputRowSets to set.public List<org.pentaho.di.core.RowSet> getOutputRowSets()
getOutputRowSets in interface StepInterfacepublic void setOutputRowSets(List<org.pentaho.di.core.RowSet> outputRowSets)
outputRowSets - The outputRowSets to set.public boolean isDistributed()
public void setDistributed(boolean distributed)
distributed - The distributed to set.public void addRowListener(RowListener rowListener)
StepInterfaceaddRowListener in interface StepInterfacerowListener - the rowlistener to addpublic void removeRowListener(RowListener rowListener)
StepInterfaceremoveRowListener in interface StepInterfacerowListener - the rowlistener to removepublic List<RowListener> getRowListeners()
getRowListeners in interface StepInterfacepublic void addResultFile(org.pentaho.di.core.ResultFile resultFile)
resultFile - the result filepublic Map<String,org.pentaho.di.core.ResultFile> getResultFiles()
getResultFiles in interface StepInterfacepublic BaseStepData.StepExecutionStatus getStatus()
getStatus in interface StepInterfaceStepDataInterfacepublic String getPartitionID()
getPartitionID in interface StepInterfacepublic void setPartitionID(String partitionID)
setPartitionID in interface StepInterfacepartitionID - the partitionID to setpublic Map<String,org.pentaho.di.core.BlockingRowSet> getPartitionTargets()
public void setPartitionTargets(Map<String,org.pentaho.di.core.BlockingRowSet> partitionTargets)
partitionTargets - the partitionTargets to setpublic int getRepartitioning()
public void setRepartitioning(int repartitioning)
setRepartitioning in interface StepInterfacerepartitioning - the repartitioning type to setpublic boolean isPartitioned()
isPartitioned in interface StepInterfacepublic void setPartitioned(boolean partitioned)
setPartitioned in interface StepInterfacepartitioned - the partitioned to setpublic org.pentaho.di.core.row.RowMetaInterface getInputRowMeta()
public void setInputRowMeta(org.pentaho.di.core.row.RowMetaInterface rowMeta)
rowMeta - the rowMeta to setpublic org.pentaho.di.core.row.RowMetaInterface getErrorRowMeta()
public void setErrorRowMeta(org.pentaho.di.core.row.RowMetaInterface errorRowMeta)
errorRowMeta - the errorRowMeta to setpublic org.pentaho.di.core.row.RowMetaInterface getPreviewRowMeta()
public void setPreviewRowMeta(org.pentaho.di.core.row.RowMetaInterface previewRowMeta)
previewRowMeta - the previewRowMeta to setpublic void copyVariablesFrom(org.pentaho.di.core.variables.VariableSpace space)
copyVariablesFrom in interface org.pentaho.di.core.variables.VariableSpacepublic String environmentSubstitute(String aString)
environmentSubstitute in interface org.pentaho.di.core.variables.VariableSpacepublic String[] environmentSubstitute(String[] aString)
environmentSubstitute in interface org.pentaho.di.core.variables.VariableSpacepublic String fieldSubstitute(String aString, org.pentaho.di.core.row.RowMetaInterface rowMeta, Object[] rowData) throws org.pentaho.di.core.exception.KettleValueException
fieldSubstitute in interface org.pentaho.di.core.variables.VariableSpaceorg.pentaho.di.core.exception.KettleValueExceptionpublic org.pentaho.di.core.variables.VariableSpace getParentVariableSpace()
getParentVariableSpace in interface org.pentaho.di.core.variables.VariableSpacepublic void setParentVariableSpace(org.pentaho.di.core.variables.VariableSpace parent)
setParentVariableSpace in interface org.pentaho.di.core.variables.VariableSpacepublic String getVariable(String variableName, String defaultValue)
getVariable in interface org.pentaho.di.core.variables.VariableSpacepublic String getVariable(String variableName)
getVariable in interface org.pentaho.di.core.variables.VariableSpacepublic boolean getBooleanValueOfVariable(String variableName, boolean defaultValue)
getBooleanValueOfVariable in interface org.pentaho.di.core.variables.VariableSpacepublic void initializeVariablesFrom(org.pentaho.di.core.variables.VariableSpace parent)
initializeVariablesFrom in interface org.pentaho.di.core.variables.VariableSpacepublic String[] listVariables()
listVariables in interface org.pentaho.di.core.variables.VariableSpacepublic void setVariable(String variableName, String variableValue)
setVariable in interface org.pentaho.di.core.variables.VariableSpacepublic void shareVariablesWith(org.pentaho.di.core.variables.VariableSpace space)
shareVariablesWith in interface org.pentaho.di.core.variables.VariableSpacepublic void injectVariables(Map<String,String> prop)
injectVariables in interface org.pentaho.di.core.variables.VariableSpacepublic String getTypeId()
public int getSlaveNr()
public int getClusterSize()
public int getUniqueStepNrAcrossSlaves()
public int getUniqueStepCountAcrossSlaves()
public List<ServerSocket> getServerSockets()
public void setServerSockets(List<ServerSocket> serverSockets)
serverSockets - the serverSockets to setpublic void setUsingThreadPriorityManagment(boolean usingThreadPriorityManagment)
setUsingThreadPriorityManagment in interface StepInterfaceusingThreadPriorityManagment - set to true to actively manage priorities of step threadspublic boolean isUsingThreadPriorityManagment()
isUsingThreadPriorityManagment in interface StepInterfacepublic void initBeforeStart()
throws org.pentaho.di.core.exception.KettleStepException
initBeforeStart in interface StepInterfaceorg.pentaho.di.core.exception.KettleStepException - In case there is an errorpublic List<StepListener> getStepListeners()
public void setStepListeners(List<StepListener> stepListeners)
stepListeners - the stepListeners to setpublic boolean processRow(StepMetaInterface smi, StepDataInterface sdi) throws org.pentaho.di.core.exception.KettleException
StepInterfaceprocessRow in interface StepInterfacesmi - The steps metadata to work withsdi - The steps temporary working data to work with (database connections, result sets, caches, temporary variables, etc.)org.pentaho.di.core.exception.KettleExceptionpublic boolean canProcessOneRow()
StepInterfaceFor example, if a step has no input records but needs at least one to function, it will return false.
canProcessOneRow in interface StepInterfacepublic void addStepListener(StepListener stepListener)
StepInterfaceaddStepListener in interface StepInterfacestepListener - The listener to add to the steppublic boolean isMapping()
isMapping in interface StepInterfacepublic SocketRepository getSocketRepository()
public void setSocketRepository(SocketRepository socketRepository)
socketRepository - the socketRepository to setpublic String getObjectName()
getObjectName in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.core.logging.LogChannelInterface getLogChannel()
getLogChannel in interface HasLogChannelInterfacegetLogChannel in interface StepInterfacepublic String getFilename()
getFilename in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic String getLogChannelId()
getLogChannelId in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.repository.ObjectId getObjectId()
getObjectId in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.repository.ObjectRevision getObjectRevision()
getObjectRevision in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.core.logging.LoggingObjectType getObjectType()
getObjectType in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.core.logging.LoggingObjectInterface getParent()
getParent in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.repository.RepositoryDirectory getRepositoryDirectory()
getRepositoryDirectory in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic String getObjectCopy()
getObjectCopy in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic org.pentaho.di.core.logging.LogLevel getLogLevel()
getLogLevel in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic void setLogLevel(org.pentaho.di.core.logging.LogLevel logLevel)
logLevel - the new log levelpublic static void closeQuietly(Closeable cl)
cl - the object that can be closed.public String getContainerObjectId()
getContainerObjectId in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic void setCarteObjectId(String containerObjectId)
containerObjectId - the containerObjectId to setpublic void batchComplete()
throws org.pentaho.di.core.exception.KettleException
StepInterfacebatchComplete in interface StepInterfaceorg.pentaho.di.core.exception.KettleException - In case an error occurs during the processing of the batch of rows.public List<RemoteStep> getRemoteInputSteps()
public List<RemoteStep> getRemoteOutputSteps()
public Date getRegistrationDate()
getRegistrationDate in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic boolean isGatheringMetrics()
isGatheringMetrics in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic void setGatheringMetrics(boolean gatheringMetrics)
setGatheringMetrics in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic boolean isForcingSeparateLogging()
isForcingSeparateLogging in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic void setForcingSeparateLogging(boolean forcingSeparateLogging)
setForcingSeparateLogging in interface org.pentaho.di.core.logging.LoggingObjectInterfacepublic Repository getRepository()
getRepository in interface StepInterfacepublic void setRepository(Repository repository)
setRepository in interface StepInterfacerepository - The repository used by the step to load and reference Kettle objects with at runtimepublic org.pentaho.metastore.api.IMetaStore getMetaStore()
getMetaStore in interface StepInterfacepublic void setMetaStore(org.pentaho.metastore.api.IMetaStore metaStore)
StepInterfacesetMetaStore in interface StepInterfacemetaStore - The metastore to usepublic int getCurrentOutputRowSetNr()
getCurrentOutputRowSetNr in interface StepInterfacepublic void setCurrentOutputRowSetNr(int index)
setCurrentOutputRowSetNr in interface StepInterfaceindex - Sets the index of the active (current) output row set to use.public int getCurrentInputRowSetNr()
getCurrentInputRowSetNr in interface StepInterfacepublic void setCurrentInputRowSetNr(int index)
setCurrentInputRowSetNr in interface StepInterfaceindex - Sets the index of the active (current) input row set to use.