Interface AnalyticsQueryResult
-
- All Superinterfaces:
Iterable<AnalyticsQueryRow>
- All Known Implementing Classes:
DefaultAnalyticsQueryResult
@Committed @Public public interface AnalyticsQueryResult extends Iterable<AnalyticsQueryRow>
Represents the results of aAnalyticsQuery, in a blocking fashion. Note that the result is complete, meaning it will block until all data has been streamed from the server.- Since:
- 2.4.3
- Author:
- Michael Nitschinger
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description List<AnalyticsQueryRow>allRows()StringclientContextId()List<JsonObject>errors()booleanfinalSuccess()Denotes the success or failure of the query.AnalyticsDeferredResultHandlehandle()AnalyticsMetricsinfo()booleanparseSuccess()StringrequestId()Iterator<AnalyticsQueryRow>rows()Objectsignature()Stringstatus()Returns the final status of the query.-
Methods inherited from interface java.lang.Iterable
forEach, iterator, spliterator
-
-
-
-
Method Detail
-
allRows
List<AnalyticsQueryRow> allRows()
- Returns:
- the list of all
AnalyticsQueryRow, the results of the query, if successful.
-
rows
Iterator<AnalyticsQueryRow> rows()
- Returns:
- an iterator over the list of all
AnalyticsQueryRow, the results of the query, if successful.
-
signature
Object signature()
- Returns:
- an object representing the signature of the results, that can be used to
learn about the common structure of each
row. This signature is usually aJsonObject, but could also be any JSON-valid type like a boolean scalar,JsonArray...
-
info
AnalyticsMetrics info()
- Returns:
- an object describing some metrics/info about the execution of the query.
-
parseSuccess
boolean parseSuccess()
- Returns:
- true if the query could be parsed, false if it short-circuited due to syntax/fatal error.
-
finalSuccess
boolean finalSuccess()
Denotes the success or failure of the query. It could fail slower than withparseSuccess(), for example if a fatal error comes up while streaming the results to the client. This method blocks until the query is over and the success can be established.
-
status
String status()
Returns the final status of the query. For example, a successful query will return "success" (which is equivalent tofinalSuccess()returning true). Other statuses include (but are not limited to) "fatal" when fatal errors occurred and "timeout" when the query timed out on the server side but not yet on the client side. This method blocks until the query is over and the status can be established.
-
errors
List<JsonObject> errors()
- Returns:
- A list of errors or warnings encountered while executing the query.
-
requestId
String requestId()
- Returns:
- the requestId generated by the server
-
clientContextId
String clientContextId()
- Returns:
- the clientContextId that was set by the client (could be truncated to 64 bytes of UTF-8 chars)
-
handle
@Experimental AnalyticsDeferredResultHandle handle()
- Returns:
- the handle to fetch results from deferred execution
-
-