Skip navigation links

com.oracle.dac.thirdparty.executor
Interface DACExecutorDescriptor

public interface DACExecutorDescriptor

DACExecutorDescriptor is a starting point for custom external executor implementation. It describes what executor does and what properties it requires. Properties need to implement com.oracle.dac.thirdparty.executor.DACExecutorProperty. Custom implementation is optional. You can use com.oracle.dac.thirdparty.executor.defaultImpl.DACExecutorPropertyImpl instead. An instance of DACExecutorDescriptor will be used by DAC code to generate required executors during ETL.

Since:

DAC 11.1.1.5.0

Method Summary

DACExecutor	createDACExecutor(java.lang.String name) Creates an instance of an executor.
java.lang.String	getDescription() Returns description of the executor implementation.
java.util.List<java.lang.String>	getExecutionContextParameterNames() Returns the list of CONTEXT names.
java.util.List<DACExecutorProperty>	getProperties() Returns a list of properties.
void	init(java.lang.String name, java.util.logging.Logger logger) Initializes descriptor.

Method Detail

init

void init(java.lang.String name,
          java.util.logging.Logger logger)

Initializes descriptor.

Parameters:

name - descriptor name (as defined in DAC Repository) that can be used for logging

logger - logger used by ETL process

getDescription

java.lang.String getDescription()

Returns description of the executor implementation. For example ODI 11g embedded agent.

Returns:

description of the executor

getProperties

java.util.List<DACExecutorProperty> getProperties()

Returns a list of properties. The properties specify what an executor instance requires for proper functioning (e.g. host, port, user name and password).

Returns:

a list of properties required by an executor

getExecutionContextParameterNames

java.util.List<java.lang.String> getExecutionContextParameterNames()

Returns the list of CONTEXT names. For each name, there will be one execution plan connectivity parameter per copy of source system container created during parameter generation. CONTEXT value is a free-form text, so you are free to give any value there.

A CONTEXT is used when: 1. external executor requires an additional parameter that is not present in DAC, and 2. the value can't be defined as a constant for the external executor instance. The value varies depending on execution plan, source system container or data source.

For example, if executor requires project id that could be different from one execution plan to another, drive through use of contexts.

Note: If no contexts are required, leave the list empty.

Returns:

list of context names

createDACExecutor

DACExecutor createDACExecutor(java.lang.String name)

Creates an instance of an executor.

Parameters:

name - executor instance name (as defined in DAC Repository)

Returns:

Skip navigation links