Class DatabaseLookupMeta
- java.lang.Object
-
- org.pentaho.di.trans.step.BaseStepMeta
-
- org.pentaho.di.trans.steps.databaselookup.DatabaseLookupMeta
-
- All Implemented Interfaces:
Cloneable,ProvidesDatabaseConnectionInformation,ProvidesModelerMeta,StepAttributesInterface,StepMetaInterface
public class DatabaseLookupMeta extends BaseStepMeta implements StepMetaInterface, ProvidesModelerMeta
-
-
Field Summary
Fields Modifier and Type Field Description static intCONDITION_BETWEENstatic intCONDITION_EQstatic intCONDITION_GEstatic intCONDITION_GTstatic intCONDITION_IS_NOT_NULLstatic intCONDITION_IS_NULLstatic intCONDITION_LEstatic intCONDITION_LIKEstatic intCONDITION_LTstatic intCONDITION_NEstatic String[]conditionStrings-
Fields inherited from class org.pentaho.di.trans.step.BaseStepMeta
attributes, databases, log, loggingObject, parentStepMeta, repository, STEP_ATTRIBUTES_FILE
-
-
Constructor Summary
Constructors Constructor Description DatabaseLookupMeta()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidallocate(int nrkeys, int nrvalues)voidanalyseImpact(List<DatabaseImpact> impact, TransMeta transMeta, StepMeta stepinfo, org.pentaho.di.core.row.RowMetaInterface prev, String[] input, String[] output, org.pentaho.di.core.row.RowMetaInterface info, Repository repository, org.pentaho.metastore.api.IMetaStore metaStore)Each step must be able to report on the impact it has on a database, table field, etc.voidcheck(List<org.pentaho.di.core.CheckResultInterface> remarks, TransMeta transMeta, StepMeta stepMeta, org.pentaho.di.core.row.RowMetaInterface prev, String[] input, String[] output, org.pentaho.di.core.row.RowMetaInterface info, org.pentaho.di.core.variables.VariableSpace space, Repository repository, org.pentaho.metastore.api.IMetaStore metaStore)Checks the settings of this step and puts the findings in a remarks List.Objectclone()Make an exact copy of this step, make sure to explicitly copy Collections etc.intgetCacheSize()List<String>getDatabaseFields()org.pentaho.di.core.database.DatabaseMetagetDatabaseMeta()Returns the database meta for this stepvoidgetFields(org.pentaho.di.core.row.RowMetaInterface row, String name, org.pentaho.di.core.row.RowMetaInterface[] info, StepMeta nextStep, org.pentaho.di.core.variables.VariableSpace space, Repository repository, org.pentaho.metastore.api.IMetaStore metaStore)Gets the fields.String[]getKeyCondition()StringgetMissingDatabaseConnectionInformationMessage()Provides a way for this object to return a custom message when database connection information is incomplete or missing.StringgetOrderByClause()String[]getReturnValueDefault()int[]getReturnValueDefaultType()String[]getReturnValueField()String[]getReturnValueNewName()org.pentaho.di.core.row.RowMetagetRowMeta(StepDataInterface stepData)StringgetSchemaName()Returns the schema name for this step.StepInterfacegetStep(StepMeta stepMeta, StepDataInterface stepDataInterface, int cnr, TransMeta transMeta, Trans trans)Get the executing step, needed by Trans to launch a step.StepDataInterfacegetStepData()Get a new instance of the appropriate data class.List<String>getStreamFields()String[]getStreamKeyField1()String[]getStreamKeyField2()org.pentaho.di.core.row.RowMetaInterfacegetTableFields()Gets the table fields.String[]getTableKeyField()StringgetTablename()StringgetTableName()Returns the table name for this steporg.pentaho.di.core.database.DatabaseMeta[]getUsedDatabaseConnections()This method returns all the database connections that are used by the step.StringgetXML()Produces the XML string that describes this step's information.booleanisCached()booleanisEatingRowOnLookupFailure()booleanisFailingOnMultipleResults()booleanisLoadingAllDataInCache()voidloadXML(Node stepnode, List<org.pentaho.di.core.database.DatabaseMeta> databases, org.pentaho.metastore.api.IMetaStore metaStore)Load the values for this step from an XML NodevoidreadRep(Repository rep, org.pentaho.metastore.api.IMetaStore metaStore, org.pentaho.di.repository.ObjectId id_step, List<org.pentaho.di.core.database.DatabaseMeta> databases)Read the steps information from a Kettle repositoryvoidsaveRep(Repository rep, org.pentaho.metastore.api.IMetaStore metaStore, org.pentaho.di.repository.ObjectId id_transformation, org.pentaho.di.repository.ObjectId id_step)Save the steps data into a Kettle repositoryvoidsetCached(boolean cached)voidsetCacheSize(int cacheSize)voidsetDatabaseMeta(org.pentaho.di.core.database.DatabaseMeta database)voidsetDefault()Set default valuesvoidsetEatingRowOnLookupFailure(boolean eatingRowOnLookupFailure)voidsetFailingOnMultipleResults(boolean failOnMultipleResults)voidsetKeyCondition(String[] keyCondition)voidsetLoadingAllDataInCache(boolean loadingAllDataInCache)voidsetOrderByClause(String orderByClause)voidsetReturnValueDefault(String[] returnValueDefault)voidsetReturnValueDefaultType(int[] returnValueDefaultType)voidsetReturnValueField(String[] returnValueField)voidsetReturnValueNewName(String[] returnValueNewName)voidsetSchemaName(String schemaName)voidsetStreamKeyField1(String[] streamKeyField1)voidsetStreamKeyField2(String[] streamKeyField2)voidsetTableKeyField(String[] tableKeyField)voidsetTablename(String tablename)booleansupportsErrorHandling()-
Methods inherited from class org.pentaho.di.trans.step.BaseStepMeta
analyseImpact, cancelQueries, check, check, createEntry, excludeFromCopyDistributeVerification, excludeFromRowLayoutVerification, exportResources, exportResources, extractStepMetadataEntries, findAttribute, findParent, findParentEntry, getActiveReferencedObjectDescription, getDescription, getDialogClassName, getFields, getLog, getLogChannelId, getName, getObjectCopy, getObjectId, getObjectRevision, getObjectType, getOptionalStreams, getParent, getParentStepMeta, getReferencedObjectDescriptions, getRepCode, getRepositoryDirectory, getRequiredFields, getRequiredFields, getResourceDependencies, getSQLStatements, getSQLStatements, getStepInjectionMetadataEntries, getStepIOMeta, getStepIOMeta, getStepMetaInjectionInterface, getSupportedTransformationTypes, getTooltip, getUsedArguments, getUsedLibraries, getXmlCode, handleStreamSelection, hasChanged, hasRepositoryReferences, isBasic, isDebug, isDetailed, isReferencedObjectEnabled, isRowLevel, loadReferencedObject, loadReferencedObject, loadStepAttributes, loadXML, loadXML, logBasic, logBasic, logDebug, logDebug, logDetailed, logDetailed, logError, logError, logError, logMinimal, logMinimal, logRowlevel, logRowlevel, lookupRepositoryReferences, readRep, readRep, resetStepIoMeta, saveRep, searchInfoAndTargetSteps, setChanged, setChanged, setParentStepMeta, setStepIOMeta
-
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.pentaho.di.trans.step.StepMetaInterface
analyseImpact, cancelQueries, check, cleanAfterHopFromRemove, cleanAfterHopFromRemove, cleanAfterHopToRemove, excludeFromCopyDistributeVerification, excludeFromRowLayoutVerification, exportResources, exportResources, extractStepMetadataEntries, fetchTransMeta, getActiveReferencedObjectDescription, getDialogClassName, getFields, getOptionalStreams, getParentStepMeta, getReferencedObjectDescriptions, getRequiredFields, getResourceDependencies, getSQLStatements, getSQLStatements, getStepIOMeta, getStepMetaInjectionInterface, getSupportedTransformationTypes, getUsedArguments, getUsedLibraries, handleStreamSelection, hasChanged, hasRepositoryReferences, isReferencedObjectEnabled, loadReferencedObject, loadXML, lookupRepositoryReferences, passDataToServletOutput, readRep, resetStepIoMeta, saveRep, searchInfoAndTargetSteps, setChanged, setParentStepMeta
-
-
-
-
Field Detail
-
conditionStrings
public static final String[] conditionStrings
-
CONDITION_EQ
public static final int CONDITION_EQ
- See Also:
- Constant Field Values
-
CONDITION_NE
public static final int CONDITION_NE
- See Also:
- Constant Field Values
-
CONDITION_LT
public static final int CONDITION_LT
- See Also:
- Constant Field Values
-
CONDITION_LE
public static final int CONDITION_LE
- See Also:
- Constant Field Values
-
CONDITION_GT
public static final int CONDITION_GT
- See Also:
- Constant Field Values
-
CONDITION_GE
public static final int CONDITION_GE
- See Also:
- Constant Field Values
-
CONDITION_LIKE
public static final int CONDITION_LIKE
- See Also:
- Constant Field Values
-
CONDITION_BETWEEN
public static final int CONDITION_BETWEEN
- See Also:
- Constant Field Values
-
CONDITION_IS_NULL
public static final int CONDITION_IS_NULL
- See Also:
- Constant Field Values
-
CONDITION_IS_NOT_NULL
public static final int CONDITION_IS_NOT_NULL
- See Also:
- Constant Field Values
-
-
Method Detail
-
isCached
public boolean isCached()
- Returns:
- Returns the cached.
-
setCached
public void setCached(boolean cached)
- Parameters:
cached- The cached to set.
-
getCacheSize
public int getCacheSize()
- Returns:
- Returns the cacheSize.
-
setCacheSize
public void setCacheSize(int cacheSize)
- Parameters:
cacheSize- The cacheSize to set.
-
getDatabaseMeta
public org.pentaho.di.core.database.DatabaseMeta getDatabaseMeta()
Description copied from interface:ProvidesDatabaseConnectionInformationReturns the database meta for this step- Specified by:
getDatabaseMetain interfaceProvidesDatabaseConnectionInformation- Returns:
- Returns the database.
-
getTableName
public String getTableName()
Description copied from interface:ProvidesDatabaseConnectionInformationReturns the table name for this step- Specified by:
getTableNamein interfaceProvidesDatabaseConnectionInformation- Returns:
-
setDatabaseMeta
public void setDatabaseMeta(org.pentaho.di.core.database.DatabaseMeta database)
- Parameters:
database- The database to set.
-
getKeyCondition
public String[] getKeyCondition()
- Returns:
- Returns the keyCondition.
-
setKeyCondition
public void setKeyCondition(String[] keyCondition)
- Parameters:
keyCondition- The keyCondition to set.
-
getOrderByClause
public String getOrderByClause()
- Returns:
- Returns the orderByClause.
-
setOrderByClause
public void setOrderByClause(String orderByClause)
- Parameters:
orderByClause- The orderByClause to set.
-
getReturnValueDefault
public String[] getReturnValueDefault()
- Returns:
- Returns the returnValueDefault.
-
setReturnValueDefault
public void setReturnValueDefault(String[] returnValueDefault)
- Parameters:
returnValueDefault- The returnValueDefault to set.
-
getReturnValueDefaultType
public int[] getReturnValueDefaultType()
- Returns:
- Returns the returnValueDefaultType.
-
setReturnValueDefaultType
public void setReturnValueDefaultType(int[] returnValueDefaultType)
- Parameters:
returnValueDefaultType- The returnValueDefaultType to set.
-
getReturnValueField
public String[] getReturnValueField()
- Returns:
- Returns the returnValueField.
-
setReturnValueField
public void setReturnValueField(String[] returnValueField)
- Parameters:
returnValueField- The returnValueField to set.
-
getReturnValueNewName
public String[] getReturnValueNewName()
- Returns:
- Returns the returnValueNewName.
-
setReturnValueNewName
public void setReturnValueNewName(String[] returnValueNewName)
- Parameters:
returnValueNewName- The returnValueNewName to set.
-
getStreamKeyField1
public String[] getStreamKeyField1()
- Returns:
- Returns the streamKeyField1.
-
setStreamKeyField1
public void setStreamKeyField1(String[] streamKeyField1)
- Parameters:
streamKeyField1- The streamKeyField1 to set.
-
getStreamKeyField2
public String[] getStreamKeyField2()
- Returns:
- Returns the streamKeyField2.
-
setStreamKeyField2
public void setStreamKeyField2(String[] streamKeyField2)
- Parameters:
streamKeyField2- The streamKeyField2 to set.
-
getTableKeyField
public String[] getTableKeyField()
- Returns:
- Returns the tableKeyField.
-
setTableKeyField
public void setTableKeyField(String[] tableKeyField)
- Parameters:
tableKeyField- The tableKeyField to set.
-
getTablename
public String getTablename()
- Returns:
- Returns the tablename.
-
setTablename
public void setTablename(String tablename)
- Parameters:
tablename- The tablename to set.
-
isFailingOnMultipleResults
public boolean isFailingOnMultipleResults()
- Returns:
- Returns the failOnMultipleResults.
-
setFailingOnMultipleResults
public void setFailingOnMultipleResults(boolean failOnMultipleResults)
- Parameters:
failOnMultipleResults- The failOnMultipleResults to set.
-
loadXML
public void loadXML(Node stepnode, List<org.pentaho.di.core.database.DatabaseMeta> databases, org.pentaho.metastore.api.IMetaStore metaStore) throws org.pentaho.di.core.exception.KettleXMLException
Description copied from interface:StepMetaInterfaceLoad the values for this step from an XML Node- Specified by:
loadXMLin interfaceStepMetaInterface- Overrides:
loadXMLin classBaseStepMeta- Parameters:
stepnode- the Node to get the info fromdatabases- The available list of databases to reference tometaStore- the metastore to optionally load external reference metadata from- Throws:
org.pentaho.di.core.exception.KettleXMLException- When an unexpected XML error occurred. (malformed etc.)
-
allocate
public void allocate(int nrkeys, int nrvalues)
-
clone
public Object clone()
Description copied from interface:StepMetaInterfaceMake an exact copy of this step, make sure to explicitly copy Collections etc.- Specified by:
clonein interfaceStepMetaInterface- Overrides:
clonein classBaseStepMeta- Returns:
- an exact copy of this step
-
setDefault
public void setDefault()
Description copied from interface:StepMetaInterfaceSet default values- Specified by:
setDefaultin interfaceStepMetaInterface
-
getFields
public void getFields(org.pentaho.di.core.row.RowMetaInterface row, String name, org.pentaho.di.core.row.RowMetaInterface[] info, StepMeta nextStep, org.pentaho.di.core.variables.VariableSpace space, Repository repository, org.pentaho.metastore.api.IMetaStore metaStore) throws org.pentaho.di.core.exception.KettleStepExceptionDescription copied from class:BaseStepMetaGets the fields.- Specified by:
getFieldsin interfaceStepMetaInterface- Overrides:
getFieldsin classBaseStepMeta- Parameters:
row- the input row meta that is modified in this method to reflect the output row metadata of the stepname- Name of the step to use as input for the origin field in the valuesinfo- Fields used as extra lookup informationnextStep- the next step that is targetedspace- the space The variable space to use to replace variablesrepository- the repository to use to load Kettle metadata objects impacting the output fieldsmetaStore- the MetaStore to use to load additional external data or metadata impacting the output fields- Throws:
org.pentaho.di.core.exception.KettleStepException- the kettle step exception
-
getXML
public String getXML()
Description copied from class:BaseStepMetaProduces the XML string that describes this step's information.- Specified by:
getXMLin interfaceStepMetaInterface- Overrides:
getXMLin classBaseStepMeta- Returns:
- String containing the XML describing this step.
-
readRep
public void readRep(Repository rep, org.pentaho.metastore.api.IMetaStore metaStore, org.pentaho.di.repository.ObjectId id_step, List<org.pentaho.di.core.database.DatabaseMeta> databases) throws org.pentaho.di.core.exception.KettleException
Description copied from interface:StepMetaInterfaceRead the steps information from a Kettle repository- Specified by:
readRepin interfaceStepMetaInterface- Overrides:
readRepin classBaseStepMeta- Parameters:
rep- The repository to read frommetaStore- The MetaStore to read external information fromid_step- The step IDdatabases- The databases to reference- Throws:
org.pentaho.di.core.exception.KettleException- When an unexpected error occurred (database, network, etc)
-
saveRep
public void saveRep(Repository rep, org.pentaho.metastore.api.IMetaStore metaStore, org.pentaho.di.repository.ObjectId id_transformation, org.pentaho.di.repository.ObjectId id_step) throws org.pentaho.di.core.exception.KettleException
Description copied from interface:StepMetaInterfaceSave the steps data into a Kettle repository- Specified by:
saveRepin interfaceStepMetaInterface- Overrides:
saveRepin classBaseStepMeta- Parameters:
rep- The Kettle repository to save tometaStore- the metaStore to optionally write toid_transformation- The transformation IDid_step- The step ID- Throws:
org.pentaho.di.core.exception.KettleException- When an unexpected error occurred (database, network, etc)
-
check
public void check(List<org.pentaho.di.core.CheckResultInterface> remarks, TransMeta transMeta, StepMeta stepMeta, org.pentaho.di.core.row.RowMetaInterface prev, String[] input, String[] output, org.pentaho.di.core.row.RowMetaInterface info, org.pentaho.di.core.variables.VariableSpace space, Repository repository, org.pentaho.metastore.api.IMetaStore metaStore)
Description copied from interface:StepMetaInterfaceChecks the settings of this step and puts the findings in a remarks List.- Specified by:
checkin interfaceStepMetaInterface- Overrides:
checkin classBaseStepMeta- Parameters:
remarks- The list to put the remarks in @see org.pentaho.di.core.CheckResultstepMeta- The stepMeta to help checkingprev- The fields coming from the previous stepinput- The input step namesoutput- The output step namesinfo- The fields that are used as information by the stepspace- the variable space to resolve variable expressions withrepository- the repository to use to load Kettle metadata objects impacting the output fieldsmetaStore- the MetaStore to use to load additional external data or metadata impacting the output fields
-
getTableFields
public org.pentaho.di.core.row.RowMetaInterface getTableFields()
Description copied from class:BaseStepMetaGets the table fields.- Specified by:
getTableFieldsin interfaceStepMetaInterface- Overrides:
getTableFieldsin classBaseStepMeta- Returns:
- the table fields
-
getStep
public StepInterface getStep(StepMeta stepMeta, StepDataInterface stepDataInterface, int cnr, TransMeta transMeta, Trans trans)
Description copied from interface:StepMetaInterfaceGet the executing step, needed by Trans to launch a step.- Specified by:
getStepin interfaceStepMetaInterface- Parameters:
stepMeta- The step infostepDataInterface- the step data interface linked to this step. Here the step can store temporary data, database connections, etc.cnr- The copy nr to gettransMeta- The transformation infotrans- The launching transformation
-
getStepData
public StepDataInterface getStepData()
Description copied from interface:StepMetaInterfaceGet a new instance of the appropriate data class. This data class implements the StepDataInterface. It basically contains the persisting data that needs to live on, even if a worker thread is terminated.- Specified by:
getStepDatain interfaceStepMetaInterface- Returns:
- The appropriate StepDataInterface class.
-
analyseImpact
public void analyseImpact(List<DatabaseImpact> impact, TransMeta transMeta, StepMeta stepinfo, org.pentaho.di.core.row.RowMetaInterface prev, String[] input, String[] output, org.pentaho.di.core.row.RowMetaInterface info, Repository repository, org.pentaho.metastore.api.IMetaStore metaStore)
Description copied from class:BaseStepMetaEach step must be able to report on the impact it has on a database, table field, etc.- Specified by:
analyseImpactin interfaceStepMetaInterface- Overrides:
analyseImpactin classBaseStepMeta- Parameters:
impact- The list of impacts @see org.pentaho.di.transMeta.DatabaseImpacttransMeta- The transformation informationstepinfo- The step informationprev- The fields entering this stepinput- The previous step namesoutput- The output step namesinfo- The fields used as information by this steprepository- the repository to use to load Kettle metadata objects impacting the output fieldsmetaStore- the MetaStore to use to load additional external data or metadata impacting the output fields
-
getUsedDatabaseConnections
public org.pentaho.di.core.database.DatabaseMeta[] getUsedDatabaseConnections()
Description copied from class:BaseStepMetaThis method returns all the database connections that are used by the step.- Specified by:
getUsedDatabaseConnectionsin interfaceStepMetaInterface- Overrides:
getUsedDatabaseConnectionsin classBaseStepMeta- Returns:
- an array of database connections meta-data. Return an empty array if no connections are used.
-
isEatingRowOnLookupFailure
public boolean isEatingRowOnLookupFailure()
- Returns:
- Returns the eatingRowOnLookupFailure.
-
setEatingRowOnLookupFailure
public void setEatingRowOnLookupFailure(boolean eatingRowOnLookupFailure)
- Parameters:
eatingRowOnLookupFailure- The eatingRowOnLookupFailure to set.
-
getSchemaName
public String getSchemaName()
Description copied from interface:ProvidesDatabaseConnectionInformationReturns the schema name for this step.- Specified by:
getSchemaNamein interfaceProvidesDatabaseConnectionInformation- Returns:
- the schemaName
-
getMissingDatabaseConnectionInformationMessage
public String getMissingDatabaseConnectionInformationMessage()
Description copied from interface:ProvidesDatabaseConnectionInformationProvides a way for this object to return a custom message when database connection information is incomplete or missing. If this returnsnulla default message will be displayed for missing information.- Specified by:
getMissingDatabaseConnectionInformationMessagein interfaceProvidesDatabaseConnectionInformation- Returns:
- A friendly message that describes that database connection information is missing and, potentially, why.
-
setSchemaName
public void setSchemaName(String schemaName)
- Parameters:
schemaName- the schemaName to set
-
supportsErrorHandling
public boolean supportsErrorHandling()
- Specified by:
supportsErrorHandlingin interfaceStepMetaInterface- Overrides:
supportsErrorHandlingin classBaseStepMeta- Returns:
- true if this step supports error "reporting" on rows: the ability to send rows to a certain target step.
-
isLoadingAllDataInCache
public boolean isLoadingAllDataInCache()
- Returns:
- the loadingAllDataInCache
-
setLoadingAllDataInCache
public void setLoadingAllDataInCache(boolean loadingAllDataInCache)
- Parameters:
loadingAllDataInCache- the loadingAllDataInCache to set
-
getRowMeta
public org.pentaho.di.core.row.RowMeta getRowMeta(StepDataInterface stepData)
- Specified by:
getRowMetain interfaceProvidesModelerMeta
-
getDatabaseFields
public List<String> getDatabaseFields()
- Specified by:
getDatabaseFieldsin interfaceProvidesModelerMeta
-
getStreamFields
public List<String> getStreamFields()
- Specified by:
getStreamFieldsin interfaceProvidesModelerMeta
-
-