com.google.api.services.bigquery.model

Class QueryRequest

java.lang.Object

java.util.AbstractMap<String,Object>

com.google.api.client.util.GenericData

com.google.api.client.json.GenericJson

com.google.api.services.bigquery.model.QueryRequest

All Implemented Interfaces:

Cloneable, Map<String,Object>

public final class QueryRequest
extends GenericJson

Model definition for QueryRequest.

This is the Java data model class that specifies how to parse/serialize into the JSON that is transmitted over HTTP when working with the BigQuery API. For a detailed explanation see: http://code.google.com/p/google-http-java-client/wiki/JSON

Author:

Google, Inc.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

GenericData.Flags

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
QueryRequest()

Method Summary

Methods

Modifier and Type	Method and Description
QueryRequest	clone()
DatasetReference	getDefaultDataset() [Optional] Specifies the default datasetId and projectId to assume for any unqualified table names in the query.
Boolean	getDryRun() [Optional] If set, don't actually run the query.
String	getKind() The resource type of the request.
Long	getMaxResults() [Optional] The maximum number of rows of data to return per page of results.
Boolean	getPreserveNulls() [Deprecated] If set to false, maps null values in the query response to the column's default value.
String	getQuery() [Required] A query string, following the BigQuery query syntax, of the query to execute.
Long	getTimeoutMs() [Optional] How long to wait for the query to complete, in milliseconds, before the request times out and returns.
Boolean	getUseQueryCache() [Optional] Whether to look for the result in the query cache.
QueryRequest	set(String fieldName, Object value)
QueryRequest	setDefaultDataset(DatasetReference defaultDataset) [Optional] Specifies the default datasetId and projectId to assume for any unqualified table names in the query.
QueryRequest	setDryRun(Boolean dryRun) [Optional] If set, don't actually run the query.
QueryRequest	setKind(String kind) The resource type of the request.
QueryRequest	setMaxResults(Long maxResults) [Optional] The maximum number of rows of data to return per page of results.
QueryRequest	setPreserveNulls(Boolean preserveNulls) [Deprecated] If set to false, maps null values in the query response to the column's default value.
QueryRequest	setQuery(String query) [Required] A query string, following the BigQuery query syntax, of the query to execute.
QueryRequest	setTimeoutMs(Long timeoutMs) [Optional] How long to wait for the query to complete, in milliseconds, before the request times out and returns.
QueryRequest	setUseQueryCache(Boolean useQueryCache) [Optional] Whether to look for the result in the query cache.

Methods inherited from class com.google.api.client.json.GenericJson

getFactory, setFactory, toPrettyString, toString

Methods inherited from class com.google.api.client.util.GenericData

entrySet, get, getClassInfo, getUnknownKeys, put, putAll, remove, setUnknownKeys

Methods inherited from class java.util.AbstractMap

clear, containsKey, containsValue, equals, hashCode, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

QueryRequest

public QueryRequest()

Method Detail

getDefaultDataset

public DatasetReference getDefaultDataset()

[Optional] Specifies the default datasetId and projectId to assume for any unqualified table names in the query. If not set, all table names in the query string must be qualified in the format 'datasetId.tableId'.

Returns:

value or null for none

setDefaultDataset

public QueryRequest setDefaultDataset(DatasetReference defaultDataset)

[Optional] Specifies the default datasetId and projectId to assume for any unqualified table names in the query. If not set, all table names in the query string must be qualified in the format 'datasetId.tableId'.

Parameters:

defaultDataset - defaultDataset or null for none

getDryRun

public Boolean getDryRun()

[Optional] If set, don't actually run the query. A valid query will return an empty response, while an invalid query will return the same error it would if it wasn't a dry run. The default value is false.

Returns:

value or null for none

setDryRun

public QueryRequest setDryRun(Boolean dryRun)

[Optional] If set, don't actually run the query. A valid query will return an empty response, while an invalid query will return the same error it would if it wasn't a dry run. The default value is false.

Parameters:

dryRun - dryRun or null for none

getKind

public String getKind()

The resource type of the request.

Returns:

value or null for none

setKind

public QueryRequest setKind(String kind)

The resource type of the request.

Parameters:

kind - kind or null for none

getMaxResults

public Long getMaxResults()

[Optional] The maximum number of rows of data to return per page of results. Setting this flag to a small value such as 1000 and then paging through results might improve reliability when the query result set is large. In addition to this limit, responses are also limited to 10 MB. By default, there is no maximum row count, and only the byte limit applies.

Returns:

value or null for none

setMaxResults

public QueryRequest setMaxResults(Long maxResults)

[Optional] The maximum number of rows of data to return per page of results. Setting this flag to a small value such as 1000 and then paging through results might improve reliability when the query result set is large. In addition to this limit, responses are also limited to 10 MB. By default, there is no maximum row count, and only the byte limit applies.

Parameters:

maxResults - maxResults or null for none

getPreserveNulls

public Boolean getPreserveNulls()

[Deprecated] If set to false, maps null values in the query response to the column's default value. Only specify if you have older code that can not handle null values in the query response. The default value is true. This flag is deprecated and will be ignored in a future version of BigQuery.

Returns:

value or null for none

setPreserveNulls

public QueryRequest setPreserveNulls(Boolean preserveNulls)

[Deprecated] If set to false, maps null values in the query response to the column's default value. Only specify if you have older code that can not handle null values in the query response. The default value is true. This flag is deprecated and will be ignored in a future version of BigQuery.

Parameters:

preserveNulls - preserveNulls or null for none

getQuery

public String getQuery()

[Required] A query string, following the BigQuery query syntax, of the query to execute. Example: "SELECT count(f1) FROM [myProjectId:myDatasetId.myTableId]".

Returns:

value or null for none

setQuery

public QueryRequest setQuery(String query)

[Required] A query string, following the BigQuery query syntax, of the query to execute. Example: "SELECT count(f1) FROM [myProjectId:myDatasetId.myTableId]".

Parameters:

query - query or null for none

getTimeoutMs

public Long getTimeoutMs()

[Optional] How long to wait for the query to complete, in milliseconds, before the request times out and returns. Note that this is only a timeout for the request, not the query. If the query takes longer to run than the timeout value, the call returns without any results and with the 'jobComplete' flag set to false. You can call GetQueryResults() to wait for the query to complete and read the results. The default value is 10000 milliseconds (10 seconds).

Returns:

value or null for none

setTimeoutMs

public QueryRequest setTimeoutMs(Long timeoutMs)

[Optional] How long to wait for the query to complete, in milliseconds, before the request times out and returns. Note that this is only a timeout for the request, not the query. If the query takes longer to run than the timeout value, the call returns without any results and with the 'jobComplete' flag set to false. You can call GetQueryResults() to wait for the query to complete and read the results. The default value is 10000 milliseconds (10 seconds).

Parameters:

timeoutMs - timeoutMs or null for none

getUseQueryCache

public Boolean getUseQueryCache()

[Optional] Whether to look for the result in the query cache. The query cache is a best-effort cache that will be flushed whenever tables in the query are modified. The default value is true.

Returns:

value or null for none

setUseQueryCache

public QueryRequest setUseQueryCache(Boolean useQueryCache)

[Optional] Whether to look for the result in the query cache. The query cache is a best-effort cache that will be flushed whenever tables in the query are modified. The default value is true.

Parameters:

useQueryCache - useQueryCache or null for none

set

public QueryRequest set(String fieldName,
               Object value)

Overrides:

set in class GenericJson

clone

public QueryRequest clone()

Overrides:

clone in class GenericJson