org.apache.flink.table.connector.source

接口 LookupTableSource

所有超级接口:

DynamicTableSource

@Experimental
public interface LookupTableSource
extends DynamicTableSource

A DynamicTableSource that looks up rows of an external storage system by one or more keys during runtime.

Compared to ScanTableSource, the source does not have to read the entire table and can lazily fetch individual values from a (possibly continuously changing) external table when necessary.

Note: Compared to ScanTableSource, a LookupTableSource does only support emitting insert-only changes currently (see also RowKind). Further abilities are not supported.

In the last step, the planner will call getLookupRuntimeProvider(LookupContext) for obtaining a provider of runtime implementation. The key fields that are required to perform a lookup are derived from a query by the planner and will be provided in the given LookupTableSource.LookupContext.getKeys(). The values for those key fields are passed during runtime.

嵌套类概要

嵌套类

限定符和类型	接口和说明
static interface	LookupTableSource.LookupContext Context for creating runtime implementation via a LookupTableSource.LookupRuntimeProvider.
static interface	LookupTableSource.LookupRuntimeProvider Provides actual runtime implementation for reading the data.

从接口继承的嵌套类/接口 org.apache.flink.table.connector.source.DynamicTableSource

DynamicTableSource.Context, DynamicTableSource.DataStructureConverter

方法概要

限定符和类型	方法和说明
LookupTableSource.LookupRuntimeProvider	getLookupRuntimeProvider(LookupTableSource.LookupContext context) Returns a provider of runtime implementation for reading the data.

从接口继承的方法 org.apache.flink.table.connector.source.DynamicTableSource

asSummaryString, copy

方法详细资料

getLookupRuntimeProvider

LookupTableSource.LookupRuntimeProvider getLookupRuntimeProvider(LookupTableSource.LookupContext context)

Returns a provider of runtime implementation for reading the data.

There exist different interfaces for runtime implementation which is why LookupTableSource.LookupRuntimeProvider serves as the base interface.

Independent of the provider interface, a source implementation can work on either arbitrary objects or internal data structures (see org.apache.flink.table.data for more information).

The given LookupTableSource.LookupContext offers utilities by the planner for creating runtime implementation with minimal dependencies to internal data structures.

另请参阅:

TableFunctionProvider, AsyncTableFunctionProvider