Package com.couchbase.client.java.query

Class QueryMetaData

java.lang.Object

com.couchbase.client.java.query.QueryMetaData

public class QueryMetaData
extends Object

Stores any non-rows results related to the execution of a particular N1QL query.

Since:

1.0.0

Author:

Graham Pople

Constructor Summary

Constructors

Constructor	Description
QueryMetaData(CoreQueryMetaData internal)

Method Summary

Modifier and Type	Method	Description
String	clientContextId()	Returns the client context identifier string set on the query request.
Optional<QueryMetrics>	metrics()	Returns the QueryMetrics as returned by the query engine if enabled.
Optional<JsonObject>	profile()	Returns the profiling information returned by the query engine which is then decoded to JsonObject
String	requestId()	Returns the request identifier string of the query request
Optional<JsonObject>	signature()	Returns the signature as returned by the query engine which is then decoded to JsonObject
QueryStatus	status()	Returns the raw query execution status as returned by the query engine
List<QueryWarning>	warnings()	Returns any warnings returned by the query engine, as a JsonArray.

Methods inherited from class java.lang.Object

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

Constructor Details

QueryMetaData

@Internal
public QueryMetaData(CoreQueryMetaData internal)

Method Details

requestId

public String requestId()

Returns the request identifier string of the query request

clientContextId

public String clientContextId()

Returns the client context identifier string set on the query request.

status

public QueryStatus status()

Returns the raw query execution status as returned by the query engine

signature

public Optional<JsonObject> signature()

Returns the signature as returned by the query engine which is then decoded to JsonObject

It is returned as an Optional which will be empty if no signature information is available.

Throws:

DecodingFailureException - when the signature cannot be decoded successfully

profile

public Optional<JsonObject> profile()

Returns the profiling information returned by the query engine which is then decoded to JsonObject

It is returned as an Optional which will be empty if no profile information is available.

Throws:

DecodingFailureException - when the profile cannot be decoded successfully

metrics

public Optional<QueryMetrics> metrics()

Returns the QueryMetrics as returned by the query engine if enabled.

Throws:

DecodingFailureException - when the metrics cannot be decoded successfully

warnings

public List<QueryWarning> warnings()

Returns any warnings returned by the query engine, as a JsonArray.

It is returned as an Optional which will be empty if no warnings were returned

Throws:

DecodingFailureException - when the warnings cannot be decoded successfully