com.google.api.services.bigquery.model

Class JobConfigurationQuery

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.JobConfigurationQuery

All Implemented Interfaces:

Cloneable, Map<String,Object>

public final class JobConfigurationQuery
extends GenericJson

Model definition for JobConfigurationQuery.

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
JobConfigurationQuery()

Method Summary

Methods

Modifier and Type	Method and Description
JobConfigurationQuery	clone()
Boolean	getAllowLargeResults() If true, allows the query to produce arbitrarily large result tables at a slight cost in performance.
String	getCreateDisposition() [Optional] Specifies whether the job is allowed to create new tables.
DatasetReference	getDefaultDataset() [Optional] Specifies the default dataset to use for unqualified table names in the query.
TableReference	getDestinationTable() [Optional] Describes the table where the query results should be stored.
Boolean	getFlattenResults() [Experimental] Flattens all nested and repeated fields in the query results.
Boolean	getPreserveNulls() [Deprecated] This property is deprecated.
String	getPriority() [Optional] Specifies a priority for the query.
String	getQuery() [Required] BigQuery SQL query to execute.
Boolean	getUseQueryCache() [Optional] Whether to look for the result in the query cache.
String	getWriteDisposition() [Optional] Specifies the action that occurs if the destination table already exists.
JobConfigurationQuery	set(String fieldName, Object value)
JobConfigurationQuery	setAllowLargeResults(Boolean allowLargeResults) If true, allows the query to produce arbitrarily large result tables at a slight cost in performance.
JobConfigurationQuery	setCreateDisposition(String createDisposition) [Optional] Specifies whether the job is allowed to create new tables.
JobConfigurationQuery	setDefaultDataset(DatasetReference defaultDataset) [Optional] Specifies the default dataset to use for unqualified table names in the query.
JobConfigurationQuery	setDestinationTable(TableReference destinationTable) [Optional] Describes the table where the query results should be stored.
JobConfigurationQuery	setFlattenResults(Boolean flattenResults) [Experimental] Flattens all nested and repeated fields in the query results.
JobConfigurationQuery	setPreserveNulls(Boolean preserveNulls) [Deprecated] This property is deprecated.
JobConfigurationQuery	setPriority(String priority) [Optional] Specifies a priority for the query.
JobConfigurationQuery	setQuery(String query) [Required] BigQuery SQL query to execute.
JobConfigurationQuery	setUseQueryCache(Boolean useQueryCache) [Optional] Whether to look for the result in the query cache.
JobConfigurationQuery	setWriteDisposition(String writeDisposition) [Optional] Specifies the action that occurs if the destination table already exists.

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

JobConfigurationQuery

public JobConfigurationQuery()

Method Detail

getAllowLargeResults

public Boolean getAllowLargeResults()

If true, allows the query to produce arbitrarily large result tables at a slight cost in performance. Requires destinationTable to be set.

Returns:

value or null for none

setAllowLargeResults

public JobConfigurationQuery setAllowLargeResults(Boolean allowLargeResults)

If true, allows the query to produce arbitrarily large result tables at a slight cost in performance. Requires destinationTable to be set.

Parameters:

allowLargeResults - allowLargeResults or null for none

getCreateDisposition

public String getCreateDisposition()

[Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.

Returns:

value or null for none

setCreateDisposition

public JobConfigurationQuery setCreateDisposition(String createDisposition)

[Optional] Specifies whether the job is allowed to create new tables. The following values are supported: CREATE_IF_NEEDED: If the table does not exist, BigQuery creates the table. CREATE_NEVER: The table must already exist. If it does not, a 'notFound' error is returned in the job result. The default value is CREATE_IF_NEEDED. Creation, truncation and append actions occur as one atomic update upon job completion.

Parameters:

createDisposition - createDisposition or null for none

getDefaultDataset

public DatasetReference getDefaultDataset()

[Optional] Specifies the default dataset to use for unqualified table names in the query.

Returns:

value or null for none

setDefaultDataset

public JobConfigurationQuery setDefaultDataset(DatasetReference defaultDataset)

[Optional] Specifies the default dataset to use for unqualified table names in the query.

Parameters:

defaultDataset - defaultDataset or null for none

getDestinationTable

public TableReference getDestinationTable()

[Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.

Returns:

value or null for none

setDestinationTable

public JobConfigurationQuery setDestinationTable(TableReference destinationTable)

[Optional] Describes the table where the query results should be stored. If not present, a new table will be created to store the results.

Parameters:

destinationTable - destinationTable or null for none

getFlattenResults

public Boolean getFlattenResults()

[Experimental] Flattens all nested and repeated fields in the query results. The default value is true. allowLargeResults must be true if this is set to false.

Returns:

value or null for none

setFlattenResults

public JobConfigurationQuery setFlattenResults(Boolean flattenResults)

[Experimental] Flattens all nested and repeated fields in the query results. The default value is true. allowLargeResults must be true if this is set to false.

Parameters:

flattenResults - flattenResults or null for none

getPreserveNulls

public Boolean getPreserveNulls()

[Deprecated] This property is deprecated.

Returns:

value or null for none

setPreserveNulls

public JobConfigurationQuery setPreserveNulls(Boolean preserveNulls)

[Deprecated] This property is deprecated.

Parameters:

preserveNulls - preserveNulls or null for none

getPriority

public String getPriority()

[Optional] Specifies a priority for the query. Possible values include INTERACTIVE and BATCH. The default value is INTERACTIVE.

Returns:

value or null for none

setPriority

public JobConfigurationQuery setPriority(String priority)

[Optional] Specifies a priority for the query. Possible values include INTERACTIVE and BATCH. The default value is INTERACTIVE.

Parameters:

priority - priority or null for none

getQuery

public String getQuery()

[Required] BigQuery SQL query to execute.

Returns:

value or null for none

setQuery

public JobConfigurationQuery setQuery(String query)

[Required] BigQuery SQL query to execute.

Parameters:

query - query 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. Moreover, the query cache is only available when a query does not have a destination table specified.

Returns:

value or null for none

setUseQueryCache

public JobConfigurationQuery 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. Moreover, the query cache is only available when a query does not have a destination table specified.

Parameters:

useQueryCache - useQueryCache or null for none

getWriteDisposition

public String getWriteDisposition()

[Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_EMPTY. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.

Returns:

value or null for none

setWriteDisposition

public JobConfigurationQuery setWriteDisposition(String writeDisposition)

[Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_EMPTY. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.

Parameters:

writeDisposition - writeDisposition or null for none

set

public JobConfigurationQuery set(String fieldName,
                        Object value)

Overrides:

set in class GenericJson

clone

public JobConfigurationQuery clone()

Overrides:

clone in class GenericJson