Package oracle.kv.query
Class ExecuteOptions
- java.lang.Object
-
- oracle.kv.query.ExecuteOptions
-
public class ExecuteOptions extends Object
Class contains several options for the execution of an SQL statement (DDL or DML). SQL statements are executed via one of the KVStore.execute() methods.
-
-
Field Summary
Fields Modifier and Type Field Description static shortDRIVER_QUERY_V2static shortDRIVER_QUERY_V3
-
Constructor Summary
Constructors Constructor Description ExecuteOptions()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description ConsistencygetConsistency()Gets the last set execution consistency.DurabilitygetDurability()Gets the last set execution durability.MathContextgetMathContext()intgetMaxConcurrentRequests()Returns the maximum number of concurrent requests.longgetMaxMemoryConsumption()Get the maximum number of memory bytes that may be consumed by the statement at the client for blocking operations, such as duplicate elimination (which may be required due to the use of an index on an array or map) and sorting (sorting by distance when a query contains a geo_near() function).StringgetNamespace()Returns the namespace to use for the query, null if not set.intgetResultsBatchSize()Returns the number of results per request.longgetTimeout()Gets the timeout, which is an upper bound on the time interval for processing the read or write operations.TimeUnitgetTimeoutUnit()Gets the unit of the timeout parameter, and may benullonly ifgetTimeout()returns zero.ExecuteOptionssetConsistency(Consistency consistency)Sets the execution consistency.ExecuteOptionssetDurability(Durability durability)Sets the execution durability.ExecuteOptionssetMathContext(MathContext mathContext)ExecuteOptionssetMaxConcurrentRequests(int maxConcurrentRequests)Sets the maximum number of concurrent requests.voidsetMaxMemoryConsumption(long v)Set the maximum number of memory bytes that may be consumed by the statement at the client for blocking operations, such as duplicate elimination (which may be required due to the use of an index on an array or map) and sorting (sorting by distance when a query contains a geo_near() function).ExecuteOptionssetNamespace(String namespace)Sets the namespace to use for the query.ExecuteOptionssetResultsBatchSize(int resultsBatchSize)Sets the number of results per request.ExecuteOptionssetTimeout(long timeout, TimeUnit timeoutUnit)Thetimeoutparameter is an upper bound on the time interval for processing the operation.
-
-
-
Method Detail
-
setConsistency
public ExecuteOptions setConsistency(Consistency consistency)
Sets the execution consistency.
-
getConsistency
public Consistency getConsistency()
Gets the last set execution consistency.
-
setDurability
public ExecuteOptions setDurability(Durability durability)
Sets the execution durability.
-
getDurability
public Durability getDurability()
Gets the last set execution durability.
-
setTimeout
public ExecuteOptions setTimeout(long timeout, TimeUnit timeoutUnit)
Thetimeoutparameter is an upper bound on the time interval for processing the operation. A best effort is made not to exceed the specified limit. If zero, thedefault request timeoutis used.If
timeoutis not 0, thetimeoutUnitparameter must not benull.- Parameters:
timeout- the timeout value to usetimeoutUnit- theTimeUnitused by thetimeoutparameter or null
-
getTimeout
public long getTimeout()
Gets the timeout, which is an upper bound on the time interval for processing the read or write operations. A best effort is made not to exceed the specified limit. If zero, thedefault request timeoutis used.- Returns:
- the timeout
-
getTimeoutUnit
public TimeUnit getTimeoutUnit()
Gets the unit of the timeout parameter, and may benullonly ifgetTimeout()returns zero.- Returns:
- the timeout unit or null
-
getMaxConcurrentRequests
public int getMaxConcurrentRequests()
Returns the maximum number of concurrent requests.
-
setMaxConcurrentRequests
public ExecuteOptions setMaxConcurrentRequests(int maxConcurrentRequests)
Sets the maximum number of concurrent requests.
-
getResultsBatchSize
public int getResultsBatchSize()
Returns the number of results per request.
-
setResultsBatchSize
public ExecuteOptions setResultsBatchSize(int resultsBatchSize)
Sets the number of results per request.
-
getMathContext
public MathContext getMathContext()
Returns theMathContextused forBigDecimalandBigIntegeroperations.MathContext.DECIMAL32is used by default.
-
setMathContext
public ExecuteOptions setMathContext(MathContext mathContext)
Sets theMathContextused forBigDecimalandBigIntegeroperations.MathContext.DECIMAL32is used by default.
-
setNamespace
public ExecuteOptions setNamespace(String namespace)
Sets the namespace to use for the query. Query specified namespace takes precedence, else this namespace value is used for unqualified table names.- Since:
- 18.3
-
getNamespace
public String getNamespace()
Returns the namespace to use for the query, null if not set.- Since:
- 18.3
-
setMaxMemoryConsumption
public void setMaxMemoryConsumption(long v)
Set the maximum number of memory bytes that may be consumed by the statement at the client for blocking operations, such as duplicate elimination (which may be required due to the use of an index on an array or map) and sorting (sorting by distance when a query contains a geo_near() function). Such operations may consume a lot of memory as they need to cache the full result set at the client memory. The default value is 100MB.- Since:
- 18.3
-
getMaxMemoryConsumption
public long getMaxMemoryConsumption()
Get the maximum number of memory bytes that may be consumed by the statement at the client for blocking operations, such as duplicate elimination (which may be required due to the use of an index on an array or map) and sorting (sorting by distance when a query contains a geo_near() function). Such operations may consume a lot of memory as they need to cache the full result set at the client memory. The default value is 100MB.
-
-