Package org.apache.flink.queryablestate.client

Class QueryableStateClient

java.lang.Object

org.apache.flink.queryablestate.client.QueryableStateClient

@PublicEvolving
@Deprecated
public class QueryableStateClient
extends Object

Deprecated.

The Queryable State feature is deprecated since Flink 1.18, and will be removed in a future Flink major version.

Client for querying Flink's managed state.

You can mark state as queryable via StateDescriptor.setQueryable(String). The state instance created from this descriptor will be published for queries when it's created on the Task Managers and the location will be reported to the Job Manager.

The client connects to a Client Proxy running on a given Task Manager. The proxy is the entry point of the client to the Flink cluster. It forwards the requests of the client to the Job Manager and the required Task Manager, and forwards the final response back the client.

The proxy, initially resolves the location of the requested KvState via the JobManager. Resolved locations are cached. When the server address of the requested KvState instance is determined, the client sends out a request to the server. The returned final answer is then forwarded to the Client.

Constructor Summary

Constructors

Constructor	Description
QueryableStateClient(String remoteHostname, int remotePort)	Deprecated. Create the Queryable State Client.
QueryableStateClient(InetAddress remoteAddress, int remotePort)	Deprecated. Create the Queryable State Client.

Method Summary

Modifier and Type	Method	Description
org.apache.flink.api.common.ExecutionConfig	getExecutionConfig()	Deprecated. Gets the ExecutionConfig.
<K,S extends org.apache.flink.api.common.state.State,V> CompletableFuture<S>	getKvState(org.apache.flink.api.common.JobID jobId, String queryableStateName, K key, org.apache.flink.api.common.typeinfo.TypeHint<K> keyTypeHint, org.apache.flink.api.common.state.StateDescriptor<S,V> stateDescriptor)	Deprecated. Returns a future holding the request result.
<K,S extends org.apache.flink.api.common.state.State,V> CompletableFuture<S>	getKvState(org.apache.flink.api.common.JobID jobId, String queryableStateName, K key, org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo, org.apache.flink.api.common.state.StateDescriptor<S,V> stateDescriptor)	Deprecated. Returns a future holding the request result.
org.apache.flink.api.common.ExecutionConfig	setExecutionConfig(org.apache.flink.api.common.ExecutionConfig config)	Deprecated. Replaces the existing ExecutionConfig (possibly null), with the provided one.
ClassLoader	setUserClassLoader(ClassLoader userClassLoader)	Deprecated. * Replaces the existing ClassLoader (possibly null), with the provided one.
CompletableFuture<?>	shutdownAndHandle()	Deprecated. Shuts down the client and returns a CompletableFuture that will be completed when the shutdown process is completed.
void	shutdownAndWait()	Deprecated. Shuts down the client and waits until shutdown is completed.

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryableStateClient

public QueryableStateClient(String remoteHostname,
                            int remotePort)
                     throws UnknownHostException

Deprecated.

Create the Queryable State Client.

Parameters:

remoteHostname - the hostname of the Client Proxy to connect to.

remotePort - the port of the proxy to connect to.

Throws:

UnknownHostException

QueryableStateClient

public QueryableStateClient(InetAddress remoteAddress,
                            int remotePort)

Deprecated.

Create the Queryable State Client.

Parameters:

remoteAddress - the address of the Client Proxy to connect to.

remotePort - the port of the proxy to connect to.

Method Detail

shutdownAndHandle

public CompletableFuture<?> shutdownAndHandle()

Deprecated.

Shuts down the client and returns a CompletableFuture that will be completed when the shutdown process is completed.

If an exception is thrown for any reason, then the returned future will be completed exceptionally with that exception.

Returns:

A CompletableFuture for further handling of the shutdown result.

shutdownAndWait

public void shutdownAndWait()

Deprecated.

Shuts down the client and waits until shutdown is completed.

If an exception is thrown, a warning is logged containing the exception message.

getExecutionConfig

public org.apache.flink.api.common.ExecutionConfig getExecutionConfig()

Deprecated.

Gets the ExecutionConfig.

setExecutionConfig

public org.apache.flink.api.common.ExecutionConfig setExecutionConfig(org.apache.flink.api.common.ExecutionConfig config)

Deprecated.

Replaces the existing ExecutionConfig (possibly null), with the provided one.

Parameters:

config - The new configuration.

Returns:

The old configuration, or null if none was specified.

setUserClassLoader

public ClassLoader setUserClassLoader(ClassLoader userClassLoader)

Deprecated.

* Replaces the existing ClassLoader (possibly null), with the provided one.

Parameters:

userClassLoader - The new userClassLoader.

Returns:

The old classloader, or null if none was specified.

getKvState

@PublicEvolving
public <K,S extends org.apache.flink.api.common.state.State,V> CompletableFuture<S> getKvState(org.apache.flink.api.common.JobID jobId,
                                                                                                           String queryableStateName,
                                                                                                           K key,
                                                                                                           org.apache.flink.api.common.typeinfo.TypeHint<K> keyTypeHint,
                                                                                                           org.apache.flink.api.common.state.StateDescriptor<S,V> stateDescriptor)

Deprecated.

Returns a future holding the request result.

Parameters:

jobId - JobID of the job the queryable state belongs to.

queryableStateName - Name under which the state is queryable.

key - The key we are interested in.

keyTypeHint - A TypeHint used to extract the type of the key.

stateDescriptor - The StateDescriptor of the state we want to query.

Returns:

Future holding the immutable State object containing the result.

getKvState

@PublicEvolving
public <K,S extends org.apache.flink.api.common.state.State,V> CompletableFuture<S> getKvState(org.apache.flink.api.common.JobID jobId,
                                                                                                           String queryableStateName,
                                                                                                           K key,
                                                                                                           org.apache.flink.api.common.typeinfo.TypeInformation<K> keyTypeInfo,
                                                                                                           org.apache.flink.api.common.state.StateDescriptor<S,V> stateDescriptor)

Deprecated.

Returns a future holding the request result.

Parameters:

jobId - JobID of the job the queryable state belongs to.

queryableStateName - Name under which the state is queryable.

key - The key we are interested in.

keyTypeInfo - The TypeInformation of the key.

stateDescriptor - The StateDescriptor of the state we want to query.

Returns:

Future holding the immutable State object containing the result.