org.apache.flink.state.api

类 ExistingSavepoint

java.lang.Object

org.apache.flink.state.api.WritableSavepoint<ExistingSavepoint>

org.apache.flink.state.api.ExistingSavepoint

@PublicEvolving
public class ExistingSavepoint
extends WritableSavepoint<ExistingSavepoint>

An existing savepoint. This class provides the entry points for reading previous existing operator states in savepoints. Operator states can be removed from and added to the set of existing operator states, and eventually, written to distributed storage as a new savepoint.

New savepoints written using this class are based on the previous existing savepoint. This means that for existing operators that remain untouched, the new savepoint only contains a shallow copy of pointers to state data that resides in the previous existing savepoint paths. This means that both savepoints share state and one cannot be deleted without corrupting the other!

另请参阅:

WritableSavepoint

方法概要

限定符和类型	方法和说明
<K,V> org.apache.flink.api.java.operators.DataSource<org.apache.flink.api.java.tuple.Tuple2<K,V>>	readBroadcastState(String uid, String name, org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo, org.apache.flink.api.common.typeinfo.TypeInformation<V> valueTypeInfo) Read operator BroadcastState from a Savepoint.
<K,V> org.apache.flink.api.java.operators.DataSource<org.apache.flink.api.java.tuple.Tuple2<K,V>>	readBroadcastState(String uid, String name, org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo, org.apache.flink.api.common.typeinfo.TypeInformation<V> valueTypeInfo, org.apache.flink.api.common.typeutils.TypeSerializer<K> keySerializer, org.apache.flink.api.common.typeutils.TypeSerializer<V> valueSerializer) Read operator BroadcastState from a Savepoint when a custom serializer was used; e.g., a different serializer than the one returned by TypeInformation#createSerializer.
<K,OUT> org.apache.flink.api.java.operators.DataSource<OUT>	readKeyedState(String uid, KeyedStateReaderFunction<K,OUT> function) Read keyed state from an operator in a Savepoint.
<K,OUT> org.apache.flink.api.java.operators.DataSource<OUT>	readKeyedState(String uid, KeyedStateReaderFunction<K,OUT> function, org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo, org.apache.flink.api.common.typeinfo.TypeInformation<OUT> outTypeInfo) Read keyed state from an operator in a Savepoint.
<T> org.apache.flink.api.java.operators.DataSource<T>	readListState(String uid, String name, org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo) Read operator ListState from a Savepoint.
<T> org.apache.flink.api.java.operators.DataSource<T>	readListState(String uid, String name, org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo, org.apache.flink.api.common.typeutils.TypeSerializer<T> serializer) Read operator ListState from a Savepoint when a custom serializer was used; e.g., a different serializer than the one returned by TypeInformation#createSerializer.
<T> org.apache.flink.api.java.operators.DataSource<T>	readUnionState(String uid, String name, org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo) Read operator UnionState from a Savepoint.
<T> org.apache.flink.api.java.operators.DataSource<T>	readUnionState(String uid, String name, org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo, org.apache.flink.api.common.typeutils.TypeSerializer<T> serializer) Read operator UnionState from a Savepoint when a custom serializer was used; e.g., a different serializer than the one returned by TypeInformation#createSerializer.
<W extends org.apache.flink.streaming.api.windowing.windows.Window> WindowReader<W>	window(org.apache.flink.api.common.typeutils.TypeSerializer<W> windowSerializer) Read window state from an operator in a Savepoint.
<W extends org.apache.flink.streaming.api.windowing.windows.Window> WindowReader<W>	window(org.apache.flink.streaming.api.windowing.assigners.WindowAssigner<?,W> assigner) Read window state from an operator in a Savepoint.

从类继承的方法 org.apache.flink.state.api.WritableSavepoint

removeOperator, withConfiguration, withOperator, write

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

readListState

public <T> org.apache.flink.api.java.operators.DataSource<T> readListState(String uid,
                                                                           String name,
                                                                           org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo)
                                                                    throws IOException

Read operator ListState from a Savepoint.

类型参数:

T - The type of the values that are in the list state.

参数:

uid - The uid of the operator.

name - The (unique) name for the state.

typeInfo - The type of the elements in the state.

返回:

A DataSet representing the elements in state.

抛出:

IOException - If the savepoint path is invalid or the uid does not exist.

readListState

public <T> org.apache.flink.api.java.operators.DataSource<T> readListState(String uid,
                                                                           String name,
                                                                           org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo,
                                                                           org.apache.flink.api.common.typeutils.TypeSerializer<T> serializer)
                                                                    throws IOException

Read operator ListState from a Savepoint when a custom serializer was used; e.g., a different serializer than the one returned by TypeInformation#createSerializer.

类型参数:

T - The type of the values that are in the list state.

参数:

uid - The uid of the operator.

name - The (unique) name for the state.

typeInfo - The type of the elements in the state.

serializer - The serializer used to write the elements into state.

返回:

A DataSet representing the elements in state.

抛出:

IOException - If the savepoint path is invalid or the uid does not exist.

readUnionState

public <T> org.apache.flink.api.java.operators.DataSource<T> readUnionState(String uid,
                                                                            String name,
                                                                            org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo)
                                                                     throws IOException

Read operator UnionState from a Savepoint.

类型参数:

T - The type of the values that are in the union state.

参数:

uid - The uid of the operator.

name - The (unique) name for the state.

typeInfo - The type of the elements in the state.

返回:

A DataSet representing the elements in state.

抛出:

IOException - If the savepoint path is invalid or the uid does not exist.

readUnionState

public <T> org.apache.flink.api.java.operators.DataSource<T> readUnionState(String uid,
                                                                            String name,
                                                                            org.apache.flink.api.common.typeinfo.TypeInformation<T> typeInfo,
                                                                            org.apache.flink.api.common.typeutils.TypeSerializer<T> serializer)
                                                                     throws IOException

Read operator UnionState from a Savepoint when a custom serializer was used; e.g., a different serializer than the one returned by TypeInformation#createSerializer.

类型参数:

T - The type of the values that are in the union state.

参数:

uid - The uid of the operator.

name - The (unique) name for the state.

typeInfo - The type of the elements in the state.

serializer - The serializer used to write the elements into state.

返回:

A DataSet representing the elements in state.

抛出:

IOException - If the savepoint path is invalid or the uid does not exist.

readBroadcastState

public <K,V> org.apache.flink.api.java.operators.DataSource<org.apache.flink.api.java.tuple.Tuple2<K,V>> readBroadcastState(String uid,
                                                                                                                            String name,
                                                                                                                            org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo,
                                                                                                                            org.apache.flink.api.common.typeinfo.TypeInformation<V> valueTypeInfo)
                                                                                                                     throws IOException

Read operator BroadcastState from a Savepoint.

类型参数:

K - The type of keys in state.

V - The type of values in state.

参数:

uid - The uid of the operator.

name - The (unique) name for the state.

keyTypeInfo - The type information for the keys in the state.

valueTypeInfo - The type information for the values in the state.

返回:

A DataSet of key-value pairs from state.

抛出:

IOException - If the savepoint does not contain the specified uid.

readBroadcastState

public <K,V> org.apache.flink.api.java.operators.DataSource<org.apache.flink.api.java.tuple.Tuple2<K,V>> readBroadcastState(String uid,
                                                                                                                            String name,
                                                                                                                            org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo,
                                                                                                                            org.apache.flink.api.common.typeinfo.TypeInformation<V> valueTypeInfo,
                                                                                                                            org.apache.flink.api.common.typeutils.TypeSerializer<K> keySerializer,
                                                                                                                            org.apache.flink.api.common.typeutils.TypeSerializer<V> valueSerializer)
                                                                                                                     throws IOException

Read operator BroadcastState from a Savepoint when a custom serializer was used; e.g., a different serializer than the one returned by TypeInformation#createSerializer.

类型参数:

K - The type of keys in state.

V - The type of values in state.

参数:

uid - The uid of the operator.

name - The (unique) name for the state.

keyTypeInfo - The type information for the keys in the state.

valueTypeInfo - The type information for the values in the state.

keySerializer - The type serializer used to write keys into the state.

valueSerializer - The type serializer used to write values into the state.

返回:

A DataSet of key-value pairs from state.

抛出:

IOException - If the savepoint path is invalid or the uid does not exist.

readKeyedState

public <K,OUT> org.apache.flink.api.java.operators.DataSource<OUT> readKeyedState(String uid,
                                                                                  KeyedStateReaderFunction<K,OUT> function)
                                                                           throws IOException

Read keyed state from an operator in a Savepoint.

类型参数:

K - The type of the key in state.

OUT - The output type of the transform function.

参数:

uid - The uid of the operator.

function - The KeyedStateReaderFunction that is called for each key in state.

返回:

A DataSet of objects read from keyed state.

抛出:

IOException - If the savepoint does not contain operator state with the given uid.

readKeyedState

public <K,OUT> org.apache.flink.api.java.operators.DataSource<OUT> readKeyedState(String uid,
                                                                                  KeyedStateReaderFunction<K,OUT> function,
                                                                                  org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo,
                                                                                  org.apache.flink.api.common.typeinfo.TypeInformation<OUT> outTypeInfo)
                                                                           throws IOException

Read keyed state from an operator in a Savepoint.

类型参数:

K - The type of the key in state.

OUT - The output type of the transform function.

参数:

uid - The uid of the operator.

function - The KeyedStateReaderFunction that is called for each key in state.

keyTypeInfo - The type information of the key in state.

outTypeInfo - The type information of the output of the transform reader function.

返回:

A DataSet of objects read from keyed state.

抛出:

IOException - If the savepoint does not contain operator state with the given uid.

window

public <W extends org.apache.flink.streaming.api.windowing.windows.Window> WindowReader<W> window(org.apache.flink.streaming.api.windowing.assigners.WindowAssigner<?,W> assigner)

Read window state from an operator in a Savepoint. This method supports reading from any type of window.

参数:

assigner - The WindowAssigner used to write out the operator.

返回:

A WindowReader.

window

public <W extends org.apache.flink.streaming.api.windowing.windows.Window> WindowReader<W> window(org.apache.flink.api.common.typeutils.TypeSerializer<W> windowSerializer)

Read window state from an operator in a Savepoint. This method supports reading from any type of window.

参数:

windowSerializer - The serializer used for the window type.

返回:

A WindowReader.