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 int
CONDITION_BETWEEN
static int
CONDITION_EQ
static int
CONDITION_GE
static int
CONDITION_GT
static int
CONDITION_IS_NOT_NULL
static int
CONDITION_IS_NULL
static int
CONDITION_LE
static int
CONDITION_LIKE
static int
CONDITION_LT
static int
CONDITION_NE
static 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 void
allocate(int nrkeys, int nrvalues)
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)
Each step must be able to report on the impact it has on a database, table field, etc.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)
Checks the settings of this step and puts the findings in a remarks List.Object
clone()
Make an exact copy of this step, make sure to explicitly copy Collections etc.int
getCacheSize()
List<String>
getDatabaseFields()
org.pentaho.di.core.database.DatabaseMeta
getDatabaseMeta()
Returns the database meta for this stepvoid
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)
Gets the fields.String[]
getKeyCondition()
String
getMissingDatabaseConnectionInformationMessage()
Provides a way for this object to return a custom message when database connection information is incomplete or missing.String
getOrderByClause()
String[]
getReturnValueDefault()
int[]
getReturnValueDefaultType()
String[]
getReturnValueField()
String[]
getReturnValueNewName()
org.pentaho.di.core.row.RowMeta
getRowMeta(StepDataInterface stepData)
String
getSchemaName()
Returns the schema name for this step.StepInterface
getStep(StepMeta stepMeta, StepDataInterface stepDataInterface, int cnr, TransMeta transMeta, Trans trans)
Get the executing step, needed by Trans to launch a step.StepDataInterface
getStepData()
Get a new instance of the appropriate data class.List<String>
getStreamFields()
String[]
getStreamKeyField1()
String[]
getStreamKeyField2()
org.pentaho.di.core.row.RowMetaInterface
getTableFields()
Gets the table fields.String[]
getTableKeyField()
String
getTablename()
String
getTableName()
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.String
getXML()
Produces the XML string that describes this step's information.boolean
isCached()
boolean
isEatingRowOnLookupFailure()
boolean
isFailingOnMultipleResults()
boolean
isLoadingAllDataInCache()
void
loadXML(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 Nodevoid
readRep(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 repositoryvoid
saveRep(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 repositoryvoid
setCached(boolean cached)
void
setCacheSize(int cacheSize)
void
setDatabaseMeta(org.pentaho.di.core.database.DatabaseMeta database)
void
setDefault()
Set default valuesvoid
setEatingRowOnLookupFailure(boolean eatingRowOnLookupFailure)
void
setFailingOnMultipleResults(boolean failOnMultipleResults)
void
setKeyCondition(String[] keyCondition)
void
setLoadingAllDataInCache(boolean loadingAllDataInCache)
void
setOrderByClause(String orderByClause)
void
setReturnValueDefault(String[] returnValueDefault)
void
setReturnValueDefaultType(int[] returnValueDefaultType)
void
setReturnValueField(String[] returnValueField)
void
setReturnValueNewName(String[] returnValueNewName)
void
setSchemaName(String schemaName)
void
setStreamKeyField1(String[] streamKeyField1)
void
setStreamKeyField2(String[] streamKeyField2)
void
setTableKeyField(String[] tableKeyField)
void
setTablename(String tablename)
boolean
supportsErrorHandling()
-
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:ProvidesDatabaseConnectionInformation
Returns the database meta for this step- Specified by:
getDatabaseMeta
in interfaceProvidesDatabaseConnectionInformation
- Returns:
- Returns the database.
-
getTableName
public String getTableName()
Description copied from interface:ProvidesDatabaseConnectionInformation
Returns the table name for this step- Specified by:
getTableName
in 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:StepMetaInterface
Load the values for this step from an XML Node- Specified by:
loadXML
in interfaceStepMetaInterface
- Overrides:
loadXML
in 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:StepMetaInterface
Make an exact copy of this step, make sure to explicitly copy Collections etc.- Specified by:
clone
in interfaceStepMetaInterface
- Overrides:
clone
in classBaseStepMeta
- Returns:
- an exact copy of this step
-
setDefault
public void setDefault()
Description copied from interface:StepMetaInterface
Set default values- Specified by:
setDefault
in 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.KettleStepException
Description copied from class:BaseStepMeta
Gets the fields.- Specified by:
getFields
in interfaceStepMetaInterface
- Overrides:
getFields
in 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:BaseStepMeta
Produces the XML string that describes this step's information.- Specified by:
getXML
in interfaceStepMetaInterface
- Overrides:
getXML
in 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:StepMetaInterface
Read the steps information from a Kettle repository- Specified by:
readRep
in interfaceStepMetaInterface
- Overrides:
readRep
in 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:StepMetaInterface
Save the steps data into a Kettle repository- Specified by:
saveRep
in interfaceStepMetaInterface
- Overrides:
saveRep
in 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:StepMetaInterface
Checks the settings of this step and puts the findings in a remarks List.- Specified by:
check
in interfaceStepMetaInterface
- Overrides:
check
in 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:BaseStepMeta
Gets the table fields.- Specified by:
getTableFields
in interfaceStepMetaInterface
- Overrides:
getTableFields
in classBaseStepMeta
- Returns:
- the table fields
-
getStep
public StepInterface getStep(StepMeta stepMeta, StepDataInterface stepDataInterface, int cnr, TransMeta transMeta, Trans trans)
Description copied from interface:StepMetaInterface
Get the executing step, needed by Trans to launch a step.- Specified by:
getStep
in 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:StepMetaInterface
Get 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:
getStepData
in 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:BaseStepMeta
Each step must be able to report on the impact it has on a database, table field, etc.- Specified by:
analyseImpact
in interfaceStepMetaInterface
- Overrides:
analyseImpact
in 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:BaseStepMeta
This method returns all the database connections that are used by the step.- Specified by:
getUsedDatabaseConnections
in interfaceStepMetaInterface
- Overrides:
getUsedDatabaseConnections
in 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:ProvidesDatabaseConnectionInformation
Returns the schema name for this step.- Specified by:
getSchemaName
in interfaceProvidesDatabaseConnectionInformation
- Returns:
- the schemaName
-
getMissingDatabaseConnectionInformationMessage
public String getMissingDatabaseConnectionInformationMessage()
Description copied from interface:ProvidesDatabaseConnectionInformation
Provides a way for this object to return a custom message when database connection information is incomplete or missing. If this returnsnull
a default message will be displayed for missing information.- Specified by:
getMissingDatabaseConnectionInformationMessage
in 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:
supportsErrorHandling
in interfaceStepMetaInterface
- Overrides:
supportsErrorHandling
in 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:
getRowMeta
in interfaceProvidesModelerMeta
-
getDatabaseFields
public List<String> getDatabaseFields()
- Specified by:
getDatabaseFields
in interfaceProvidesModelerMeta
-
getStreamFields
public List<String> getStreamFields()
- Specified by:
getStreamFields
in interfaceProvidesModelerMeta
-
-